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GPI, die grafische Pro- 
grammierschnittstelle 
des MS OS/2 Presen- 
tation Managers, 
kann Fonts nahezu 
genauso gut manipu- 
lieren wie PostScript. 
Der Windows- und 
MS OS/2-Experte 
Charles Petzold zeigt 
anhand vieler Bei- 
spiele, wie vielseitig 
und leistungsfähig die 
Vektorfonts unter 
dem MS OS/2-Presen- 
tation Managers sind. 
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Editorial 


ies ist bereits die zwölfte 

Ausgabe des Microsoft 
System Journals. Microsoft bietet 
damit seit nunmehr zwei Jahren 
deutschsprachigen Systement- 
wicklern, Programmierern und 
professionellen Softwarenutzern 
alle zwei Monate eine Software- 
Zeitschrift als Ratgeber an. 

Von Anfang an war es unsere 
Absicht, ein »Power-Blatt« für 
»Power-User« zu schaffen, ein 
Magazin, wie es im deutschen 
Zeitschriftenmarkt bislang nicht 
zu finden war. Mit Hilfe einer 
unabhängigen Redaktion ist es 
uns in den vergangenen beiden 
Jahren gelungen, das Microsoft 
System Journal als qualitativ 
hochwertige Software-Zeitschrift 
für Abonnenten zu etablieren. 

Der Ruf des Blattes lebt von 
fachkundigen Redakteuren und 
freien Mitarbeitern, und nicht 
zuletzt vom Expertenpotential 
aus den Entwicklungsabteilun- 
gen von Microsoft. Die regel- 
mäßigen Beiträge von renom- 
mierten Systementwicklern aus 
den USA, aus den Labors von 
Microsoft, aber auch anderer 
Softwareschmieden, haben das 
System Journal zu einem trans- 
atlantischen Knowhow-Impor- 
teur werden lassen. 

Heute gibt es in Europa je- 
doch zahlreiche eigenständige 
Software-Entwicklungen. Unab- 
hängige Programmierer haben 
ebenso wie große Computer- 
häuser qualitativ gegenüber dem 
»Mutterland« der PC-Technolo- 
gie aufgeholt. Es ist deshalb an 
der Zeit, das Microsoft System 
Journal stärker als bisher für 
Originalbeiträge aus der Bun- 
desrepublik Deutschland, der 
Schweiz und aus Österreich zu 
öffnen. 

Zugleich wollen wir der Zeit- 
schrift neue Leserkreise er- 
schließen. Die vorliegende Aus- 
gabe ist das erste Heft, das 


Microsoft in einer Kooperation 
mit dem Vogel Verlag auch über 
Kioske und den Fachbuchhandel 
vertreibt. So kommen Know-how 
und Erfahrung eines renommier- 
ten Verlages und das technologi- 
sche Know-how von Microsoft 
und seiner Redaktion zum Nut- 
zen einer breiteren Leser- 
gemeinde zusammen. 

Mit der Öffnung für Kioskver- 
trieb und Einzelverkauf wollen 
wir jedoch das technische 
Niveau nicht senken. Auch wenn 
eine Verbreiterung der Leser- 
schaft mit einer thematischen 
Verbreiterung einhergeht, bleibt 
das Microsoft System Journal die 
Zeitschrift für die qualifizierte 
Minderheit der professionellen 
Entwickler. Wir werden uns 
nach wie vor der avanciertesten 
Technologien widmen. Im Mit- 
telpunkt unserer Berichterstat- 
tung werden also auch künftig 
MS OS/2, Windows, SQL, Netz- 
werk- und Datenbanktechniken 
stehen. Wir werden vor allem 
über die Programmierung in 
modernen Hochsprachen wie C 
und FORTRAN berichten. Stär- 
ker als bisher werden wir auf 
aktuelle Tendenzen im High- 
End-Hardwaremarkt eingehen, 
also zum Beispiel auf EISA, MCA 
und Netzwerktechnik. 

Unsere weiteren Themen aber 
beschließen Sie — unsere Leser! 
Ihnen gehört diese Zeitschrift, 
auf Ihre Bedürfnisse wollen wir 
eingehen, auf Ihre Erfahrungen 
sind wir angewiesen. Deshalb 
beachten Sie bitte unsere Leser- 
befragung auf Seite 101. 

Und nun viel Spaß mit dem 
neuen Microsoft System Journal! 


Christian Wedell 


Geschäftsführer 
der Microsoft GmbH 
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GPI, die grafische Programmier- 
schnittstelle des Presentation 
Managers, kann Fonts nahezu 
genauso gut manipulieren wie 
PostScript. Der Windows- und 
OS/2-Experte Charles Petzold 
zeigt, wie vielseitig und lei- 
stungsfähig die Vektorfonts des 
Presentation Managers sind. 


Die Maus ist einfach zu pro- 
grammieren und die Systemauf- 
rufe von OS/2 für die Maus sind 
nicht schwieriger als die für die 
Tastatur, wie in diesem Buch- 
auszug demonstriert wird. 


Anwendungen mit einem Hilfe- 
Modul werden schneller erlernt, 
vielfältiger genutzt und letzt- 
endlich auch öfters verkauft. 
Jedes Programm sollte also ein 
Hilfe-Modul besitzen, auch 
Windows-Programme. 


Viele professionelle Programmie- 
rer denken, daß Basic eine Spiel- 
zeugsprache ist und nichts für 
ernsthafte Programmentwick- 
lung. Diese Einschätzung 
beginnt sich zu ändern, wie 
Ethan Winer, der Autor einer 
bekannten Basic-Toolbox, in 
einem Interview erläutert. 


Mit QuickPascal wird die über- 
aus erfolgreiche Quick-Spra- 
chen-Reihe um einen leistungs- 
starken Pascal-Compiler erwei- 
tert. Beeindruckend sind vor 
allem seine objektorientierten 
Leistungsmerkmale. 


Unter MS-DOS ist der Haupt- 
speicher knapp, deshalb ent- 
stand die virtuelle Speicherver- 
waltung VMM (Virtual Memory 
Manager). 


Dialogboxen kommt als Teil des 
SAA-Konzepts eine große Bedeu- 
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Rahmen unserer SAA-Serie 
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und eine Umsetzung in C zeigen. 
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System Journals bringen wir in 
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... und der sechste, der kann 
ruhig noch ein wenig warten, 
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Der Windows- und OS/2-Experte 
Charles Petzold zeigt, wie vielseitig 
und leistungsfähig die Vektorfonts 
des Presentation Managers sind. 


Vektorfonts 
unter dem 
Presentation 
Manager 


Lassen Sie mich mit einer Frage 
beginnen: Welche grafische Pro- 
grammiersprache speichert Fonts 
als Linien und Kurven (und nicht 
als Bitmaps) und ermöglich es 
dadurch, daß die Fonts beliebig 
gestreckt, umrahmt, mit beliebigen 
Mustern gefüllt oder sogar als 
Clipping-Bereiche verwendet wer- 
den können? Eine naheliegende 
Antwort ist PostScript, die Seiten- 
beschreibungssprache von Adobe, 
die in vielen leistungsfähigen 
Laserdruckern verwendet wird 
(zum Beispiel dem Apple Laser- 
Writer) und Fotosatzbelichtern wie 
den Linotronic-Systemen von Lino- 
type. In den letzten Jahren ist 
PostScript zur Standardsprache für 
die Computermanipulation von 
Fonts und Text geworden. Eine 
gleichermaßen gültige Antwort ist 
GPI (Graphics Programming Inter- 
face), die grafische Programmier- 
schnittstelle des OS/2 Presentation 
Managers. 


n diesem Artikel wird gezeigt, wie man unter 

GPI mit Vektorfonts arbeitet und es werden 
viele PostScript-Techniken demonstriert. Wie Sie 
noch sehen werden, hat das GPI die Fähigkeiten, 
nahezu alles mit Fonts zu machen, was man auch 
unter PostScript tun kann. Das GPI hat jedoch 
einen kleinen Nachteil, auf den ich noch am 
Ende des Artikels eingehen werde. 


Die Probleme mit Text 


Die Anzeige von Text ist immer der problema- 
tischste Teil eines grafischen Programmier- 
systems. Anders als Linien und Polygone (die 
einfach nur mathematische Gebilde sind), richtet 
Text sich nach einer langen Tradition ästheti- 
scher Typographie. Es muß in jedem Computer- 
grafik-System das Ziel sein, Text ebenso sauber 
und leicht lesbar anzuzeigen, wie in einem ge- 
druckten Buch. Doch die meisten Ausgabegeräte 
(wie Bildschirme und Drucker) sind digitale 
Medien. Die subtil geformten und gerundeten 
Zeichen, aus denen traditionelle Fonts bestehen, 
müssen für die Speicherung in einzelne Pixel zer- 
legt und auf dem Ausgabegerät wieder zusam- 
mengesetzt werden. Dies führt oft zu Verzerrun- 
gen in der Darstellung eines Textes. 

Ein wesentlicher Vorteil der Verwendung eines 
Computers für diese Arbeit ist seine Vielseitig- 
keit. Man kann eine breite Palette von Fonts in 
verschiedenen Größen und Charakteristiken ver- 
wenden und sie für die Anzeige modifizieren. 
Das Ausmaß, in dem man Fonts verändern kann, 
hängt davon ab, wie Fonts gespeichert werden. 


Bitmaps und Vektoren 


Ein Font wird im allgemeinen im Computer 
(oder Drucker) auf eine von zwei Arten gespei- 
chert. Zum einen kann ein Font als Abbild oder 
Bitmap gespeichert werden. Jedes Zeichen eines 
Fonts ist einfach nur ein rechteckiges Bit-Array. 
Null-Bits stellen dabei im allgemeinen den Hin- 
tergrund um das Zeichen herum dar und Einser- 
Bits bilden das Zeichen selbst. Zum anderen 
kann ein Font im Vektor- oder Umrißformat 
(Outline) gespeichert sein, wobei jedes Zeichen 
als eine Reihe von Linien und Kurven definiert 
ist, die Bereiche umschließen. Das Zeichen wird 
dadurch angezeigt, daß der Umriß auf dem Aus- 
gabegerät gezeichnet und die umschlossenen Be- 
reiche gefüllt werden. 

Bitmap- und Vektorfonts haben jeweils eigene 
Vor- und Nachteile. Bitmap-Fonts werden immer 
in bestimmten Fontgrößen für bestimmte Geräte- 
auflösungen erzeugt. Die Größe eines Bitmap- 
fonts kann nicht auf einfache Weise geändert 
werden. (So führt beispielsweise die Vergröße- 
rung eines Bitmapfonts durch Verdoppelung der 
Pixel-Zeilen und Spalten zumeist zu einer Ver- 


er 
# VECTFONT make file 
# 


CL=c1 -€ -625W -W3 $*.c 


vectfont.obj : vectfont.c vectfont.h 
$(CL) 


vf00.obj : vf00.c vectfont.h 
$(cL) 


vf0l.obj : vf0l.c vectfont.h 
$(CL) 


vf02.obj : vf02.c vectfont.h 
$(cL) 


vf03.obj : vf03.c vectfont.h 
$(CL) 


— 


vf04.obj : vf04.c vectfont. 
$(CL) 


vf05.0bj : vf05.c vectfont. 
$(cL) 


= 


= 


vf06.0bj : vfO6.c vectfont. 
(cL) 

vf07.obj 
$(cL 


vf08.obj : vf08.c vectfont.h 
$(CL) 


: vf07.c vectfont.h 


vf09.obj : vf09.c vectfont.h 
$(CL) 


vf10.obj : vfl0.c vectfont.h 
$(cL) 


vfll.obj : vfll.c vectfont.h 
$(cL) 


vf12.obj : vfl2.c vectfont.h 
$(cL) 


= 


vf13.obj : vfl3.c vectfont. 
$(CL) 


= 


vf1l4.obj : vfl4.c vectfont. 
$(cL) 


= 


vf15.0bj : vfl5.c vectfont. 
$(CL) 


vectfont.res : vectfont.rc vectfont.h 
rc -r vectfont 


vectfont.obj vf00.obj vf0l.obj vf02.obj vf03.0bj \ 
vf04.obj vf05.0bj vf06.obj vf07.obj \ 
vf08.obj vf09.obj vfl0.obj vfll.obj \ 
vf12.obj vf13.0bj vfl4.obj vf1l5.0bJ \ 
vectfont.def 


vectfont.exe : 


link @vectfont.Ink 
rc vectfont.res 


vectfont.exe : vectfont.res 
rc vectfont.res 


vectfont.obj + 

vf00.obj + vfOl.obj + vf02.obj + vf03.obj + 
vf04.obj + vf05.0bj + vf06.obj + vf07.obj + 
vf08.0bj + vf09.obj + vf10.obj + vfll.obj + 
vfl2.obj + vfl3.0bj + vfl4.obj + vf15.0bj 
vectfont.exe /align:16 

NUL 

0s2.lib 

vectfont.def 


gröberung der Zeichendarstellung.) Bitmapfonts 
können auch nur schlecht rotiert werden, außer 
eventuell um 90 Grad. 

Vektorfonts sind wesentlich besser formbar. 
Da sie als eine Reihe von Linien und Kurven defi- 
niert sind, können Vektorfonts auf jede beliebige 
Größe gestreckt oder gestaucht und in jedem be- 
liebigen Winkel gedreht werden. Vektorfonts 
sind nicht an eine bestimmte Geräteauflösung 
gebunden. 


; VECTFONT.DEF module definition file 


NAME VECTFONT WINDOWAPI 


DESCRIPTION 
PROTMODE 
HEAPSIZE 1024 
STACKSIZE 8192 

EXPORTS ClientWndProc 


"Vector Font Demo Program (C) Charles Petzold, 1988' 


[e— 
VECTFONT.H header file 
7 j 


- 


#define ID_RESOURCE 


#define IDM_NOTHING 
#define IDM_24POINT 
#define IDM_STRETCH 
#define IDM_MIRROR 
#define IDM_CHARANGLE 
#define IDM_ROTATE 
#define IDM_CHARSHEAR 
#define IDM_SHADOW 
#define IDM_HOLLOW 
#define IDM_DROPSHADOW 
#define IDM_BLOCK 10 
#define IDM_NEON 11 
#define IDM_FADE 12 
#define IDM_SPOKES 13 
#define IDM_WAVY 14 
#define IDM_MODSPOKES 15 


».osan2wn oo 


#define LCID_MYFONT IL 
#define ID_PATH 1L 
#define PI 3.14159 


LONG CreateVectorFfont (HPS hps, LONG Icid, CHAR *szFacename) ; // VFOO 
BOOL ScaleVectorFfont (HPS hps, SHORT xPointSize, SHORT yPointSize) ; 
B00L ScaleFontToBox (HPS hps, LONG cbText, CHAR *szText, LONG cxBox, 
LONG cyBox) ; 
VOID QueryStartPointInTextBox (HPS hps, LONG cbText, CHAR *szText, 
POINTL *ppt]) ; 
VOID ColorClient (HPS hps, LONG cxClient, LONG cyClient, LONG IColor) ; 


VOID Display_24Point (HPS hps, LONG cxClient, LONG cyClient) ; // VFOl 
voID Display_Stretch (HPS hps, LONG cxClient, LONG cyClient) ; // VFO2 
vOID Display _Mirror (HPS hps, LONG cxClient, LONG cyClient) ; /1 9F03 


vOID Display _CharAngle (HPS hps, LONG cxClient, LONG cyClient) ; // VFO4 
VoID Display_Rotate (HPS hps, LONG cxClient, LONG cyClient) ; I NFo5 
vo1D Display _CharShear (HPS hps, LONG cxClient, LONG cyClient) ; // VFO6 
VOID Display Shadow (HPS hps, LONG cxClient, LONG cyClient) ; // vr07 
voID Display _Hollow (HPS hps, LONG cxClient, LONG cyClient) ; /1 NF08 
VoID Display_DropShadow (HPS hps, LONG cxClient, LONG cyClient) ;// VF09 


vOID Display_Block (HPS hps, LONG cxClient, LONG cyClient) ; {1 vF10 
vOID Display _Neon (HPS hps, LONG cxClient, LONG cyClient) ; /I vr 
voID Display_Fade (HPS hps, LONG cxClient, LONG cyClient) ; /I vr12 
voID Display_Spokes (HPS hps, LONG cxClient, LONG cyClient) ; JI vF13 
VOID Display_Wavy (HPS hps, LONG cxClient, LONG cyClient) ; /1 vF14 


voID Display_ModSpokes (HPS hps, LONG cxClient, LONG cyClient) ; // VFIS 


Im allgemeinen sind Bitmapfonts jedoch bes- 
ser zu lesen als Vektorfonts. Es werden eine 
Reihe von Techniken verwendet, um Bitmapfonts 
so aufzubauen, daß das Auge sie für sauberer 
hält, als sie eigentlich sind. Vektorfonts können — 
besonders wenn sie auf Geräten mit geringer 
Auflösung angezeigt oder auf kleine Größen her- 
unterskaliert werden — nur mit mathematischen 
Algorithmen angepaßt werden, was zur Zeit 
noch weniger befriedigend ist, als die Arbeit 
eines menschlichen Font-Designers. Ein weiterer 
Vorteil von Bitmapfonts ist die Performance, da 
Vektorfonts in der Regel für das Zeichnen jedes 
einzelnen Zeichens wesentlich mehr Zeit erfor- 
dern. 

Die meisten üblichen Laserdrucker speichern 
Fonts als Bitmaps, entweder im Drucker selbst 
oder in Font-Kassetten. Der Drucker ist auf 
bestimmte Fontgrößen beschränkt und sie kön- 
nen nicht beliebig gedreht werden. 


44 Listing 1: 
VECTFONT 


“Listing 3: 
VECTFONT.DEF 


«Listing 4: 
VECTFONT.H 


44 Listing 2: 
VECTFONT.LNK 
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VECTFONT.C — Vector Font Demo Program 
—— tr / 


#define INCL_WIN 
#define INCL_GPI 
#include <os2.h> 
#include "vectfont.h" 


MRESULT EXPENTRY ClientWndProc (HWND, USHORT, MPARAM, MPARAM) ; 
HAB hab ; 
int main (void) 


( 
static CHAR szClientClass [] = “VectFont“ ; 


static ULONG flFrameFlags = FCF_TITLEBAR | FCF_SYSMENU | 
FCF_SIZEBORDER | FCF_MINMAX | 
FCF_SHELLPOSITION | FCF_TASKLIST | 
FCF MENU ; 

HMO ; 

HWND hwndFrame, hwndClient ; 

AUSG qmsg ; 


hab = WinInitialize (0) ; 
hmg = WinCreateMsgQueue (hab, 0) ; 


WinRegisterClass (hab, szClientClass, ClientWndProc, 
CS_SIZEREDRAW, 0) ; 


hwndFrame = WinCreateStdWindow (HWND DESKTOP, WS_VISIBLE, 
AflFrameflags, szClientllass, 
* - Vector Font Demo", OL, 
NULL, ID_RESOURCE, &hwndClient) ; 


WinSendMsg (hwndFrame, WM SETICON, 
WinQuerySysPointer (HWND_DESKTOP, SPTR_APPICON, FALSE), 
NULL) ; 


while (WinGetMsg (hab, &qmsg, NULL, 0, 0)) 
WinDispatchMsg (hab, &amsg) ; 


WinDestroyWindow (hwndFrame) ; 
WinDestroyMsgQueue (hmg) ; 
WinTerminate (hab) ; 

return 0 ; 


} 


MRESULT EXPENTRY ClientWndProc (HWND hwnd, USHORT msg, MPARAM mp1, 
MPARAM mp2) 
{ 


static struct { 
SHORT idCmd ; 
vOIO (*fn) (HPS, LONG, LONG) ; 
} 


vectfont [] = { 
IDM NOTHING, NULL, 


1DM_24POINT, Display_24Point, 
10M_MIRROR, Display_Mirror, 
IDM_STRETCH, Display_Stretch, 
IDM_CHARANGLE, Display_CharAngle, 
IDM_ROTATE, Display_Rotate, 
IDM_CHARSHEAR, Display_CharShear, 
10M_SHADOW, Display_Shadow, 
IDM_HOLLOW, Display_Hollow, 


IOM _DROPSHADOW, Display _DropShadow, 


10M_BLOCK, Display_Block, 
1DM_NEON, Display_Neon, 
IOM_FADE, Display_Fade, 
10M_SPOKES, Display_Spokes, 
DM _WAVY, Display _Wavy, 

IOM MODSPOKES, Display_ModSpokes 


I; 
static HDC hdc ; 
static HPS hps ; 
static HWND hwndMenu ; 
static POINTL ptiClient ; 
static SHORT sNumRoutines = sizeof vectfont / sizeof vectfont[0], 
sDisplay = IDM NOTHING ; 


INT 1; 
RECTL rel ; 
SIZEL sizl ; 


switch (msg) 


case WM CREATE: 
hdc = WinOpenWindowDE (hwnd) ; 
/l Create PS use Twips page units 
sizl.cı=0; 
sizl.cy=0; 
hps = GpiCreatePS (hab, hdc, Bsizl, 
PU_TWIPS | GPIF_DEFAULT | 
GPIT_MICRO | GPIALASSOC) ; 
/1 Adjust Page Viewport for points 
GpiQueryPageViewport (hps, Arcl) ; 
rcl.xRight *= 20 ; 
rcl.yTlop *= 20; 
6piSetPageViewport (hps, Arcl) ; 


hwndMenu = WinWindowFromiD ( 
WinQueryWindow (hwnd, QW_PARENT, FALSE), 
FID_MENU) ; 

retum 0 ; 


case WM SIZE: 
pt!Client.x = SHORTIFROMMP (mp2) ; 
ptiClient.y = SHORT2FROMMP (mp2) ; 


4 client width 
/l client height 


GpiConvert (hps, CVTC_DEVICE, CVTC_PAGE, IL, &ptiClient); 
return 0 ; 


case WM_COMMAND: 
for (i = 0 ; i < sNumRoutines ; i++) 
if (COMMANDMSG (ämsg)->cmd == vectfont[i]. idCmd) 
{ 


if (sDisplay == COMMANDMSG (Amsg)->cmd) 
return 0; 


WinSendMsg (hwndMenu, MM_SETITEMATTR, 
MPFROM2SHORT (sDisplay, TRUE), 
MPFROM2SHORT (MIA_CHECKED, 0)) ; 


sDisplay = COMMANDMSG(&msg)->cmd ; 


WinSendMsg (hwndMenu, MM_SETITEMATTR, 
MPFROM2SHORT (sDisplay, TRUE), 
MPFROMZSHORT (MIA_CHECKED, 

MIA_CHECKED)) ; 


WinInvalidateRect (hwnd, NULL, FALSE) ; 
return 0 ; 
} 


break ; 


case WM_PAINT: 
WinBeginPaint (hwnd, hps, NULL) ; 
GpiErase (hps) ; 
// Display hourglass pointer 


WinSetPointer (HWND_DESKTOP, 
WinQuerySysPointer (HWND_DESKTOP,SPTR_WAIT,FALSE)); 


if (1WinQuerySysValue (HWND_DESKTOP, SV_MOUSEPRESENT)) 
WinShowPointer (HWND_DESKTOP, TRUE) ; 


// Execute font routine 


for (i = 0 ; i < sNumRoutines ; i++) 
if (sDisplay == vectfont[i].idCmd) 


if (vectfont[i].fn != NULL) 
{ 


GpiSavePpS (hps) ; 

vectfont[i].fn (hps, ptlClient.x, 
ptiClient.y) ; 

GpiRestorePpS (hps, -IL) ; 

} 


break ; 
/1 Display arrow pointer 


if (!WinQuerySysValue (HWND_DESKTOP, SV_MOUSEPRESENT)) 
WinShowPointer (HWND_DESKTOP, FALSE) ; 


WinSetPointer (HWND_DESKTOP, 
. WinQuerySysPointer (HWND_DESKTOP,SPTR_ARROW,FALSE)); 


WinEndPaint (hps) ; 
return 0 ; 


case WM_DESTROY: 
GpiDestroyPS (hps) ; 
return 0 ; 


} 
return WinDefWindowProc (hwnd, msg, mpl, mp2) ; 
} 


Wesentlich vielseitiger sind die Fonts, die in 
PostScript-Druckern gespeichert werden. Diese 
Fonts sind als Vektoren gespeichert. PostScript- 
Fonts können auf jede beliebige Größe ver- 
größert oder verkleinert werden, sie können be- 
liebig gedreht, mit verschiedenen Mustern gefüllt 
und für das Clipping verwendet werden. 


Die GPI-Fonts 


Das GPI kann natürlich die Vorteile der Fonts 
nützen, die in Ausgabegeräten (z.B. Laserdruk- 
kern) gespeichert und von ihnen unterstützt 
werden. Es enthält aber auch eigene Unterstüt- 
zung für sowohl Bitmap- als auch Vektorfonts. 


Programmieren statt Bücherwälzen! 
Das neue Microsoft QuickG 2.0. 


ira Babe nie taken 7 


GEISBEISPIELAT IMG, 


+“ Initialisiert alle Wert-Datenfelder auflZIJEZEZETTZZ 
for( iFolge = 0; iFolge < MAXFOLGEN; IFolgliEszTu zz rer 


{ 


for( iVert = 0; iWert < MAXWERTE; Ile 
aertlifolgelliWert] = _P6_NISSING 


Uarınbli 


Su 


xWertlifolgel 5 _P6 NGVALUE:; 
ayWertlifolge) = _P&_MISSINGVALUE; 


for( iVert = 0; iWert < MAXWERTE; ie 


{ 


axWertMSlifolgellilert]) = _P6_MISSINGVALUE; 
aybertSLiFolgelliVert]T=WPGINISSINGVALUE; 


} 
} 


/# Nullreihen initialisieren. 


cFolge = 6; 


Mit Microsoft QuickC 2.0 beherr- 
schen Sie die Programmiersprache C 
im Handumdrehen. Mit dem neuen 
interaktiven Lernprogramm QC-Ex- 
press können Sie schon nach kurzer 
Zeit produktiv werden und Ihre ersten 
Programme austesten. Hierbei unter- 
stützt Sie eine neue, auf der Hypertext- 
Technologie basierende Hilfefunktion, 
der QC-Ratgeber. Der Microsoft 
QC-Ratgeber ist ein elektronisches 
Handbuch, das die Beschreibung aller 
C-Befehle enthält. Durch viele Quer- 
verweise und Beispiele zu jedem 
C-Befehl können Sie sämtliche 
Themengebiete per Mausklick oder 
E1-Taste komfortabel am Bildschirm 
Bearbeiten. Der QC-Ratgeber macht 
Schluß, mit zeitintensivem Suchen 
dad Nachschlagen im Handbuch. 
Auch Programimbeispiele können per 


Tastendruck kopiert und sofort in 
QuickC ausprobiert werden! 
Microsoft QuickC 2.0 garantiert 
schnelle Entwicklungs- und Ausfüh- 
rungszeiten. Neben den vom MICRO- 
SOFT COMPILER 5.1 bekannten Opti- 
mierungstechniken wurde QuickC 
nun um die Möglichkeit erweitert, 
zeitkritische Funktionen durch In- 
Line-Assembler-Routinen effektiver 
zu gestalten. 

Holen Sie sich Microsoft QuickC 
2.0: State-of-the-Art für nur 339,- DM 
(unverbindliche Preisempfehlung). 


Ims/Dos]) (me 512/um) 31:54 


ZUKUNFT DER SOFTWARE 


Neue umfangreiche 
integrierte Hilfstunk- 
tionen 
- Computergestütztes 
Lernprogramm 

- Komplettes 
C-Befehislexikon 

- Viele C-Beispiele, auf 
Knopfdruck kopierbar 

Inkrementeller Com- 
piler: übersetzt bis zu 
25.000 Zeilen/Minute 

 In-Line Assembler 

® Integrierte Entwick- 
lungsumgebung mit 
komfortablem Debugger 
der zweiten Generation 

Speichermodelle: 
Small, Medium, Com- 
pact, Large, Huge inner- 
halb der Umgebung 

U Umfangreiche Gra- 
fikbibliothek, z.B. Bar/ 
Pie-Charts/Windows- 
Schriftfonts 

Mixed-Language 
Programmieren 
- [MICROSOFT PASCAL, 

MASM, FORTRAN, 
QUICKBASIC) 

MAKE-, LIB-, LINK- 
Utilities 
@ Maus-Unterstützung 
optional 
®@ Grafikunterstützung 
von VGA, EGA, CGA, Her- 
kules-Karte und Olivetti 
@ Volle Kompatibilität 
zum MS-C 5.1 Compiler 


* 


> Tabelle 1: 

Die dynamischen 
Link-Library-Dateien 
von 05/2 1.1. Die 
Fontnamen stehen in 
Anführungszeichen, 
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Dynamic-Link-Library-Datei 
Abbild-Fonts Vector-Fonts 
COURIER.FON 

"Courier" (8, 10 und "Courier" 

12 Punkte für CGA, "Courier Bold" 
EGA, VGA und "Courier Italic" 


IBM Proprinter) "Courier Bold Italic" 
HELV.FON 

"Helv" 

(8, 10, 12, 14, "Helv" 

18 und 24 Punkte "Helv Bold" 

für CGA, EGA, VGA "Helv Italic" 

und IBM Proprinter) "Helv Bold Italic 
TIMES.FON 

"Tms Rmn" (8, 10, 12, "Tms Rmn" 

14, 18 und 24 Punkte "Tms Rmn Bold" 
für CGA, EGA, VGA, "Tms Rmn Italic" 
und IBM Proprinter) "Tms Rmn Bold Italic" 


Die Bitmapfonts waren zu erwarten, da sie 
sich besonders gut für Bildschirme mit geringer 
Auflösung und Matrixdrucker eignen. Bitmap- 
fonts sind ein wichtiger Bestandteil der meisten 
grafischen Programmiersysteme (zum Beispiel 
des Microsoft Windows GDI). 

Die Existenz von Vektorfonts im GPI ist eine 
wahre Wonne. GPI kann diese Vektorfonts mit 
jedem Ausgabegerät verwenden. So können nun 
verschiedene Fonttechniken, die bisher nur auf 
PostScript-Druckern verwendet werden konnten, 
auch auf anderen Laserdruckern und sogar auf 
dem Bildschirm eingesetzt werden. 

Die OS/2 Version 1.1 wird mit drei dynami- 
schen Link-Libraries geliefert, die nur Ressourcen 
enthalten und die Namenserweiterung FON tra- 
gen. Dabei handelt es sich um Fontdateien. Ihr 
Inhalt wird in der Tabelle 1 beschrieben. Darüber 
hinaus können auch die Bildschirm- (DIS- 
PLAY.DLL) und Druckertreiber Fonts enthalten, 
die speziell für dieses Gerät entworfen wurden. 
So ist beispielsweise der proportionale Standard- 
systemfont in DISPLAY.DLL gespeichert. 

Wenn Sie einen der Fonts in den Fontdateien 
verwenden wollen, müssen Sie sie über das Con- 
trol Panel-Programm des Presentation Managers 
installieren. Man braucht nur einen Font aus 
jeder der Dateien installieren, und man braucht 
dies auch nur einmal zu tun. 

Jeder Font hat einen Namen, der in der 
Tabelle 1 in Anführungszeichen steht. Jeder Bit- 
mapfont ist in verschiedenen Punktgrößen und 
für verschiedene Ausgabegeräte verfügbar: CGA, 
EGA, VGA (und 8514/A) und den IBM Proprin- 
ter. 


N En een en ea a 
VF0O.C — Routines for working with vector fonts 
* 
/ 


#define INCL_WIN 
#define INCL_GPI 
#include <os2.h> 
#include <stdlib.h> 
#include sstring.h> 
#include "vectfont.h" 


extern HAB hab ; 
LONG CreateVectorfont (HPS hps, LONG Icid, CHAR *szFacename) 
{ 
FATTRS fat ; 
fat.usRecordlength = sizeof fat ; 
fat.fsSelection :0; 
fat.1Match -0; 
fat.idRegistry =0; 
fat.usCodePage = GpiQueryCp (hps) ; 
fat.1MaxBaselineExt = 0 ; 
fat.lAveCharkidth =0; 
fat.fsType "0; 
fat.fsFontUse = FATTR_FONTUSE_OUTLINE | 
FATTR_FONTUSE_TRANSFORMABLE ; 
strepy (fat.szFacename, szFacename) ; 


return GpiCreatelogFont (hps, NULL, Icid, Afat) ; 
} 


B00L ScaleVectorfont (HPS hps, SHORT xPointSize, SHORT yPointSize) 
{ 
HDC hide ; 
LONG xDeviceRes, yDeviceRes ; 
POINTL ptlFont ; 
SIZEF sizfx ; 
/l Get device resolution in pixels per meter 
hdc = GpiQueryDevice (hps) ; 


DevQueryCaps (hdc, CAPS_HORIZONTAL_RESOLUTION, IL, &xDeviceRes) ; 
DevQueryCaps (hdc, CAPS_VERTICAL_RESOLUTION, IL, &yDeviceRes) ; 


// Find desired font size in pixels 


ptlFont.x = 254L * xPointSize * xDeviceRes / 7200000. ; 
ptlFont.y = 254L * yPointSize * yDeviceRes / 7200000. ; 


/l Convert to page units 
GpiConvert (hps, CVTC_DEVICE, CVTC_PAGE, IL, &ptlFont) ; 
/l Set the character box 


sizfx.cx = MAKEFIXED (ptlFont.x, 0) ; 
sizfx.cy = MAKEFIXED (ptlFont.y, 0) ; 


return GpiSetChardox (hps, Asizfx) ; 
} 
800L ScaleFontToBox (HPS hps, LONG cbText, CHAR *szText, LONG cxBox, 
LONG cyBox) 
{ 


POINTL apt![TXTBOX_COUNT] ; 
SIZEF sizfx ; 


GpiQueryCharßox (hps, Asizfx) ; 
GpiQueryTextBox (hps, chText, szText, TXTBOX_COUNT, aptl) ; 


sizfx.cx = sizfx.cx / 
(max (apt![TXTBOX_TOPRIGHT].x, apt![TXTBOX_BOTTOMRIGHT].x) — 
min (apti[TXTBOX_TOPLEFT].x, apt! [TXTB0X_BOTTOMLEFT] .x)) 
* cxBox ; 


sizfx.cy = sizfx.cy / 
(max (apt! [TXT80X_TOPRIGHT] ‘Yr apt [TXTBOX_TOPLEFT] .y) - 
min (aptI[TXT80X_BOTTOMRIGHT] .y, apt![TXTBOX_BOTTOMLEFT] ..y)) 
” cyBox ; 
return GpiSetCharßBox (hps, Asizfx) ; 
} 
vOID QueryStartPointInTextBox (HPS hps, LONG chText, CHAR *szText, 
POINTL *ppt1) 
{ 
POINTL apt1[TXTBOX_COUNT] ; 
GpiQueryTextBox (hps, cbText, szText, TXTBOX_COUNT, aptl) ; 
ppti->x = max(-aptI[TXTBOX_TOPLEFT].x, -apt![TXTBOX_BOTTOMLEFT] .x); 
ppt!->y = max(-apt1[TXTBOX_TOPLEFT].y, -apt1[TXTBOX_BOTTOMLEFT] .y); 
} 
vOID ColorCiient (HPS hps, LONG cxCiient, LONG cyClient, LONG Color) 
{ 
RECTL rel ; 
WinSetRect (hab, ärcl, 0, 0, (SHORT) cxClient, (SHORT) cyClient) ; 


WinFillRect (hps, ärcl, IColor) ; 
} 


Das GPI kann Variationen dieser Fonts wie kur- 
sive und fette Versionen erzeugen. Vektorfonts 
brauchen dagegen nicht für ein bestimmtes Aus- 
gabegerät oder eine Punkgröße erzeugt werden, 
da sie beliebig skaliert werden können. Sie kön- 
nen der Tabelle entnehmen, daß auch kursive 
und fette Versionen der Fonts vorhanden sind. 

Die Vektorfonts des GPI gleichen den Fonts 
Courier, Helvetica und Times, die in den meisten 
PostScript-Druckern enthalten sind. 

Eine nähere Untersuchung der Fontdateien 
zeigt, daß die Vektorfonts als eine Reihe von 
GPI-Zeichenanweisungen codiert sind. Wenn es 
mit diesen Fonts Text zeichnet, setzt das GPI 
diese Zeichenanweisungen in GPI-Funktionen 
um, gewöhnlich GpiPolyLine zum Zeichnen von 
geraden Linien und GpiPolyFilletSharp zum 
Zeichnen von Kurven. 


Das Programm VECTFONT 


Das Programm VECTFONT demonstriert die Ver- 
wendung der GPI-Vektorfonts. Für eine bessere 
Übersicht habe ich das Programm in mehrere 
Module aufgeteilt. Die Dateien, die das Grund- 
gerüst des Programms ausmachen, sind VECT- 
FONT, VECTFONT.LNK, VECTFONT.DEF, VECT- 
FONT.H und VECTFONT.C (Listing 1 bis 5). 

Das Display-Menü von VECTFONT enthält 16 
Optionen. Die erste Option (nichts anzeigen) ist 
die Standardeinstellung. Die anderen 15 Optio- 
nen entsprechen den Routinen in den Dateien 
VF01.C bis VF15.C, die weiter unten beschrieben 
werden (Listings 8 bis 22). Die Datei VF00.C 
(Listing 7) enthält einige Hilfsfunktionen, die von 
den Routinen in VF01.C bis VF15.C verwendet 
werden. 

VECTFONT legt bei der Meldung WM_CRE- 
ATE einen Micro-Präsentationsbereich an, wobei 
als Seiteneinheiten (page units) PU_TWIPS ver- 
wendet werden. (Twips ist ein Kunstwort, das 
ein Zwanzigstel eines Punkts bedeutet. Ein Punkt 
entspricht 1/72 eines Zolls, eine Seiteneinheit 
entspricht also 1/1440 eines Zolls.) VECTFONT 
modifiziert den rechteckigen Seiten-Viewport 
dann so, daß eine Seiteneinheit einem Punkt ent- 
spricht, was dem Standard-Koordinatensystem in 
PostScript entspricht. 

Auch wenn VECTFONT auf dem Bildschirm 
ausgibt, sind Vektorfonts ganz offensichtlich bes- 
ser für Laserdrucker geeignet. Wie Sie noch 
sehen werden, ist das Aussehen der Fonts (selbst 
bei 24 Punkt) nicht annähernd so gut, wie bei 
Bitmapfonts. 

Sie werden auch feststellen, daß mehrere der 
Demonstrationsroutinen in VECTFONT einige 
Sekunden Laufzeit benötigen. Für andere Pro- 
gramme als Demonstrationsprogramme sollten 
Sie besser einen zweiten Ausführungsthread ver- 
wenden, um das Anhalten der Meldungsverarbei- 
tung zu vermeiden. 


| 222] 
ispk 
Courier - abcdeig 
Courier Italic - abcdefg 
Courier Bold - abodefg 
Courier Bold Italio - abodefg 


I* 
VFO1.C — Display 24-point vector fonts 
——  / 


#define INCL_GPI 
#include <os2.h> 
#include <string.h> 
#include "vectfont.h" 


vOID Display_24Point (HPS hps, LONG cxClient, LONG cyClient) 


{ 
static CHAR *szFacename[] = { 
"Courier", "Courier Italic", 
“Courier Bold*, “Courier Bold Italic", 
*Tms Rmn”, "Tms Rmn Italic", 
"Tms Rımn Bold*, *Tms Rmn Bold Italic", 
"Helv Italic", 
"Helv Bold Italic" 


"Helv", 
"Helv Bold", 


Is 
static INT iNumFonts = sizeof szFacename / sizeof szFacename[0) ; 
FONTMETRICS fm ; 
INT iFont ; 
POINTL ptl ; 


ptl.x = cxClient /8 ; 
ptl.y = cyClient ; 


for (iFont = 0 ; iFont < iNumfonts ; 
{ 


iFont++) 

/H Create font, select it and scale 
CreateVectorfont (hps, LCID_MYFONT, szFacename[iFont]) ; 
GpiSetCharSet (hps, LCID_MYFONT) ; 
ScaleVectorfont (hps, 240, 240) ; 


// Get font metrics for scaled font 


GpiQueryFontMetrics (hps, (LONG) sizeof (FONTMETRICS), Afm) ; 
ptl.y -= fm.1MaxBaselineExt ; 


/ Display the font facename 


GpiCharStringAt (hps, &ptl, (LONG) strien (szFacename[iFont]), 
szFacename[ifont]) ; 


GpiCharString (hps, 10L, " — abcdefg") ; 


GpiSetCharSet (hps, LCID_ DEFAULT) ; 
GpiDeleteSetid (hps, LCID_MYFONT) ; 
} 


/I Clean up 


Auswahl eines Outline-Fonts 


Um in einem Presentation Manager-Programm 
einen Outline-Font zu verwenden, muß man 
zunächst einen logischen Font erzeugen und den 
Font dann in einen Präsentations-Bereich wäh- 
len. Die Funktion GpiCreateLogFont erzeugt 
einen logischen Font und verbindet ihn mit einer 
lokalen ID (man kann eine Zahl zwischen IL und 
254L wählen). Diese Funktion erfordert einen 
Zeiger auf eine Struktur vom Typ FATTRS (Font- 
attribute) die die Attribute des Fonts, den man 
möchte, angibt. 


“Bild 1: 

Die GPI-Vektorfonts 
in einer Größe von 
24 Punkt 
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> Bild 2: 

Ein Vektorfont in der 
Größe des Client- 
Fensters 


>> Bild 3: 
Vektorfont mit posi- 
tiven/negativen 
Zeichenboxwerten 
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/* 


VF02.C — Display vector font stretched to client window 
TEE EEE.) 


#define INCL_GPI 
#include <os2.h> 
#include *"vectfont.h" 


VOID Display_Stretch (HPS hps, LONG cxClient, LONG cyClient) 
{ 


static CHAR szText[] = "Hello!" ; 
static LONG cbText = sizeof szText - 1; 
POINTL pti ; 


/} Create font, select, and scale 


CreateVectorFont (hps, LCID_MYFONT, "Tms Rmn Italic") ; 
GpiSetCharSet (hps, LCID_MYFONT) ; 

ScaleFontToßBox (hps, cbText, szText, cxClient, cyClient) ; 
QueryStartPointInTextBox (hps, cbText, szText, äptl) ; 


GpiCharStringAt (hps, Sptl, cbText, szText) ; /1 Display text 


GpiSetCharSet (hps, LCID_DEFAULT) ; // Clean up 


GpiDeleteSetid (hps, LCID_MYFONT) ; 
} 


Um einen Vektorfont zu erzeugen, können die 
meisten Felder dieser Struktur auf Null gesetzt 
werden. Die wichtigsten Felder sind szFacename 
(das den Fontnamen enthält, einen der Namen in 
der letzten Spalte von Tabelle 1) und fsFontUse, 
das auf die konstanten Bezeichner FATTR_FONT- 
USE _OUTLINE und FATTR_FONTUSE TRANS- 
FORMABLE, kombiniert mit dem C-Bitoperator 
OR, gesetzt wird. 

Eventuell ziehen Sie es vor, in VF00.C die 
Funktion CreateVectorFont zu verwenden. Diese 
Funktion erfordert nur eine Handle für den Prä- 
sentationsbereich, die lokale ID und den Font- 
namen: 

CreateVectorFont(hps, Icid, szFacename); 

Nachdem sie einen logischen Font erzeugt 
haben (entweder mit GpiCreateLogFont oder 
CreateVectorFont), können Sie den Font in den 
Präsentationsbereich wählen: 
GpiSetChar$et(hps, 1cid); 

Der Parameter lcid ist die lokale ID des Fonts. 
Nachdem der Font in den Präsentationsbereich 
gewählt wurde, kann man die Attribute des Fonts 
mit den verschiedenen weiter unten beschriebe- 
nen Funktionen verändern, Informationen über 
den Font mit GpiQueryFontMetrics, GpiQuery- 
WidthTable und GpiQueryTextBox abfragen und 
den Font für die Textausgabe mit einer Textfunk- 
tion wie GpiCharStringAt verwenden. 


= Dal 
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VF03.C — Display four strings in mirror reflections 
*/ 


#define INCL_GPI 
#include <os2.h> 
#include *vectfont.h" 


voID Display Mirror (HPS hps, LONG cxClient, LONG cyClient) 
{ 


static CHAR szText[] = "Mirror" ; 
static LONG cbText = sizeof szText - 1; 
Int 8 
POINTL ptl ; 
SIZEF sizfx ; 
/} Create font, select and scale 


CreateVectorfont (hps, LCID_MYFONT, "Tms Rmn Italic") ; 
GpiSetCharSet (hps, LCID_MYFONT) ; 
ScaleFontToßBox (hps, cbText, szText, cxClient / 2, cyClient / 2) ; 


ptl.x = cxClient / 2; /l Center of client window 


ptl.y = cyClient /2; 


for ((=0;i1<4; im) 
{ 
GpiQueryCharBox (hps, Asizfx) ; 


iffr(i=1ı|ji=-3) 
sizfx.cx *=-1; 
// Negate char box dimensions 
if i = 2) 
sizfx.cy "= -1; 
GpiSetCharBox (hps, Asizfx) ; 
GpiCharStringAt (hps, &ptl, cbText, szText) ; 


} 
GpiSetCharSet (hps, LCID_DEFAULT) ; 
GpiDeleteSetid (hps, LCID_MYFONT) ; 


} 


/ Clean up 


Wenn Sie den Font nicht länger benötigen, 
wählen Sie einfach den Standardfont in den Prä- 
sentationsbereich: 

GpiSetCharSet(hps, LCID_DEFAULT); 

und löschen dann die lokale ID, die mit dem 
Font verknüpft wurde: 

GpiDeleteSetId(hps, Icid); 

In VECTFONT verwende ich immer den Be- 
zeichner LCID_MYFONT für die lokale ID. Er 
wird in VECTFONT.H als 1L definiert. 


Auf Punktgröße skalieren 


Wenn Sie GpiSetCharSet aufrufen, um einen 
Vektorfont in den Präsentationsbereich zu wäh- 
len, hängen die ursprüngliche Breite und Höhe 
des Fonts von der GPI-Zeichenbox ab, die die 
Zeichenbreite und -höhe in Seiteneinheiten defi- 
niert. 


/* 


VFOs.C — Display eight character angles 
ee en ER a BE TEE 


#define INCL_GPI 
#include <os2.h> 
#include «stdio.h> 
#include "vectfont.h“ 


voID Display_CharAngle (HPS hps, LONG cxClient, LONG cyClient) 
{ 


static GRADIENTL agrad![8] = { 100, 0, 100, 100, 
0, 100, -100, 100, 
-100, 0, -100, -100, 
0, -100, 100, -100 } ; 
CHAR szBuffer[40] ; 
INT ilndex ; 
POINTL pt; 


// Create Helvetica font 


CreateVectorfont (hps, LCID_MYFONT, *Helv*) ; 
GpiSetCharSet (hps, LCID_MYFONT) ; 
ScaleVectorfont (hps, 200, 200) ; 

ptl.x = cxClient / 2 ; // Center of client window 
ptl.y = cyClient /2; 


for (ilndex = 0 ; iIndex < 8 ; iIndex++) 


{ 
GpiSetCharAngle (hps, agradl + ilndex) ; // Char angle 
GpiCharStringAt (hps, &ptl, 
(LONG) sprintf (szBuffer, * Character Angle (%1d,%41d)*, 
agradl[ilndex].x, agradi[ilndex].y), 
szBuffer) ; 


) 
GpiSetCharSet (hps, LCID_DEFAULT) ; 
GpiDeleteSetid (hps, LCID_MYFONT) ; 
} 


/l Clean up 


Die Standard-Zeichenbox basiert auf der 
Größe des Standard-Systemfonts. Man kann die 
Größe der Zeichenbox durch einen Aufruf von 
GpiSetCharBox verändern. 

Auf einen wichtigen Punkt muß hier hingewie- 
sen werden: Um einen richtig proportionierten 
Vektorfont zu erhalten, muß man die Zeichen- 
boxgröße verändern. Verwenden Sie nicht die 
Standardeinstellung. Im allgemeinen stellen Sie 
die Höhe einer Zeichenbox auf die gewünschte 
Höhe des Fonts ein. Wenn Sie möchten, daß ein 
Vektorfont eine normale Breite hat, stellen Sie 
die Breite der Zeichenbox auf den gleichen Wert, 
wie die Höhe. Für einen schmaleren Font stellen 
Sie die Breite der Zeichenbox kleiner als die 
Höhe ein, für einen breiteren Font größer als die 
Höhe. 

Wenn Sie mit der Seiteneinheit PU_PELS ar- 
beiten, müssen Sie die Ausmaße der Zeichenbox 
auch noch an die Unterschiede in der waagrech- 
ten und senkrechten Auflösung des Ausgabe- 


44 Bild 4: 
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#define INCL_GPI 


VF05.C — Display "Hello, world* in circle 


“Bild 5: 
Ein Zeichenstring auf 
einem Kreisumfang 
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VF04.C 


3% «Listing‘11: 


VFOS.C 


#include <os2.h> 
#include <math.h> 
#include <stdlib.h> 
#include "vectfont.h* 


VOID Display Rotate (HPS hps, LONG cxClient, LONG cyClient) 
{ 


static CHAR szText[] = "Hello, world! * ; 

static LONG cbText = sizeof szText - IL ; 

static LONG alWidthTable[256] ; 

double ang, angCharWidth, angChar ; 

FONTMETRICS fm ; 

GRADIENTL gradl ; 

INT iChar ; 

LONG ICircum, IRadius, ITotWidth, ICharRadius, cyChar ; 
POINTL ptl ; 


/l Create the font and get font metrics 


CreateVectorfont (hps, LCID_MYFONT, "Tms Rmn*) ; 
GpiSetCharSet (hps, LCID_MYFONT) ; 


GpiQueryFontMetrics (hps, (LONG) sizeof fm, Afm) ; 

/1 Find circle dimensions and scale font 
lRadius = min (cxClient / 4, cyClient / 4) ; 
ICircum = (LONG) (2 * PI * IRadius) ; 
cyChar = fm.lMaxBaselineExt * IRadius / fm.IMaxAscender ; 
ScalefontToßox (hps, cbText, szText, ICircum, cyChar) ; 

// Obtain width table and total width 
GpiQueryWidthTable (hps, OL, 256L, alWidthTable) ; 


for (1TotWidth = 0, iChar = 0 ; iChar < (INT) cbText ; iChar ++) 
1TotWidth += alWidthTable [szText [iChar]] ; 


ang =PI /2; /1 Initial angle for first character 


for (iChar = 0 ; iChar < (INT) cbText ; iChar++) 


{ 
/l Set character angle 


angCharWidth = 2 * PI * alWidthTable [szText [iChar]] / ITotWidth ; 


gradl.x = (LONG) (1Radius * cos (ang - angCharkidth / 2 — P 
gradl.y = (LONG) (IRadius * sin (ang - angCharkidth / 2 - P 


1/2)); 
1/2)); 
GpiSetCharAngle (hps, &gradi) ; 

/H Find position for character and display it 


angChar = atan2 ((double) alWidthTable [szText [iChar]] / 2, 
(double) IRadius) ; 


ICharRadius = (LONG) (lRadius / cos (angChar)) ; 
angChar += ang - angCharWidth / 2 ; 


ptl.x = (LONG) (cxClient / 2 + ICharRadius * cos (angChar)) ; 
‚ptl.y = (LONG) (cyClient / 2 + ICharRadius * sin (angChar)) ; 


“, 
anf6piCharStringAt (hps, äptl, IL, szText + iChar) ; 
Ri 


he.) 
As.ang — angCharkidth ; 
.) 


x 


GpiS@tCharset (hps, LCID DEFAULT) ; 


2 // Clean up 
GpideleteSetid (hps, LCID_MYFONT) ; 
} 
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> Bild 6: 

Dies ist kein Bild- 
schirmfehler, son- 
dern ein Beispiel für 
die Zeichenneigung 
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Display 


RETTET 
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Onaratter Snear AN 00) 


Character Shear (0,100) 
Character Shear (41,100) 
CARHESHS SIAQY ING IDG 
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| —  — sp ee 
VF06.C — Display seven different character shear angles 
ee MEET TEEN, 


#define INCL_GPI 
#include <os2.h> 
#include <stdio.h> 
#include "vectfont.h” 


vOoID Display_CharShear (HPS hps, LONG cxClient, LONG cyClient) 


static POINTL aptiShear[7] = { -100, 41, -100, 100, 
-41, 100, 0, 100, 
41, 100, 100, 100, 
100, 41}; 

CHAR szBuffer[40] ; 

FONTMETRICS fm; 

INT ilndex ; 

POINTL ptl; 


/l Create and scale Helvetica font 


CreateVectorfont (hps, LCID_MYFONT, "Helv*) ; 
GpiSetCharSet (hps, LCID_MYFONT) ; 
ScaleVectorFont (hps, 480, 480) ; 


/l Set font metrics for scaled font 
GpiQueryFontMetrics (hps, (LONG) sizeof (FONTMETRICS), Afm) ; 


ptl.x = cxClient / 8; 
ptl.y = cyClient ; 
for (ilndex = 0; 


ilndex < 7 ; ilndex++) 


GpiSetCharShear (hps, aptIShear + ilndex) ; // Char shear 
ptl.y -= fm.1MaxBaselineExt ; 


GpiCharStringAt (hps, Aptl, 
(LONG) sprintf (szBuffer, "Character Shear (%1d,%1d)", 
apt!Shear[iindex] .x, apt!Shear[iIndex] .y), 
szöuffer) ; 


GpiSetCharSet (hps, LCID_DEFAULT) ; 
GpiDeleteSetid (hps, LCID_MYFONT) ; 
} 


/i Clean up 


geräts anpassen. Aus diesem Grund ist es wesent- 
lich einfacher, bei Vektorfonts eine der metri- 
schen Seiteneinheiten (PU_LOENGLISH, PU_HI- 
ENGLISH, PU_LOMETRIC, PU_HIMETRIC oder 
PU_TWIPS) zu verwenden. Bei diesen Seitenein- 
heiten sind die waagrechten und senkrechten 
Seiteneinheiten gleich. Nehmen wir zum Beispiel 
an, sie verwenden die Seiteneinheit PU_TWIPS. 
Dies bedeutet, daß eine Seiteneinheit 1/20 eines 
Punktes oder 1/1440 eines Zolls entspricht. Nach 
der Wahl eines Vektorfonts in den Präsentations- 
bereich möchten Sie den Font auf 24 Punkt 
skalieren. Zunächst definieren Sie dazu eine 
Struktur vom Typ SIZEF: 
SIZEF sizfx; 

Die beiden Felder dieser Struktur mit den 
Namen cx und cy werden als 32-Bit-FIXED-Zah- 


len interpretiert, das bedeutet, die höherwertigen 
16 Bit werden als Integer und die niederwertigen 
16 Bit als Bruch interpretiert. 

Wenn Sie einen Vektorfont auf eine 24-Punkt- 
Höhe skalieren wollen, können Sie das Makro 
MAKEFIXED verwenden, um die Felder der 
Struktur folgendermaßen zu belegen: 
sizfx.cx = MAKEFIXED(24 * 20, 0); 
sizfx.cy = MAKEFIXED(24 * 20, 0); 

Die Multiplikation mit 20 ist notwendig, um 
die Punktgröße in Twips umzuwandeln. Rufen 
Sie dann GpiSetCharBox auf: 
GpiSetCharBox(hps, &sizfx); 

nach der Einstellung der Zeichenbox spiegelt 
jedes Zeichen- oder Textmaß, das Sie mit Gpi- 
QueryFontMetrics, GpiQueryTextBox und Gpi- 
QueryWidthTable abfragen, die neue Fontgröße 
wider. 

Die Routine ScalevectorFont in VF00.C kann 
bei der Skalierung eines Vektorfonts auf die ge- 
wünschte Fontgröße behilflich sein. Diese Funk- 
tion arbeitet mit beliebigen Seiteneinheiten, so- 
gar mit PU_PELS. Der zweite und dritte Para- 
meter von ScaleVectorFont geben eine Punkt- 
größe in einer Einheit von 0,1 Punkt an. (240 
steht zum Beispiel für 24 Punkt.) Wenn Sie einen 
normal proportionierten Vektorfont wünschen, 
setzen Sie den dritten Parameter auf den glei- 
chen Wert wie den zweiten. 

Die Datei VF01.C in Listing 8 zeigt, wie die 
bisher besprochenen Funktionen dazu verwendet 
werden können, um alle verfügbaren Vektorfonts 
in einer Größe von 24 Punkt anzuzeigen. Sie 
können die Funktion aus VF01.C starten, indem 
Sie die Option »24 Point Fonts« aus dem »Dis- 
play«-Menü von VECTFONT auswählen. Der 
Quellcode ist in Listing 8 zu sehen, sein Ergebnis 
in Bild 1. 


Beliebige Größen 


Neben der Skalierung des Vektorfonts auf eine 
bestimmte Punktgröße kann man Vektorfonts 
auch so skalieren, daß Sie in ein beliebiges 
Rechteck passen. Als Beispiel sei genannt, daß 
man einen kurzen Textstring so skalieren 
möchte, daß er das Client-Fenster ausfüllt. 

Die Funktion in VF02.C (Listing 9) zeigt, wie 
dies gemacht wird. Sie können diese Funktion 
mit dem Menüpunkt »Stretched Font« aus dem 
Menü von VECTFONT starten. Die Funktion zeigt 
das Wort »Hello!« in der Schrift Tms Rmn Italic 
und in der Größe des Client-Fensters an. 

Die Funktion ScaleToFontBox in VF00.C hilft 
bei der Erledigung dieses Jobs. Diese Funktion 
ruft zunächst GpiQueryTextBox auf, um die 
Koordinaten des Parallelogramms zu erhalten, 
das den Textstring umgibt. Die Zeichenbox wird 
dann auf der Basis der Größe dieser Textbox und 
des Rechtecks, in das der Text eingepaßt werden 


soll, skaliert. Die Funktion QueryStartPoint- 
InTextBox in VF00.C bestimmt den Startpunkt 
des Textstrings (das heißt, den Punkt auf der 
Grundlinie links vom ersten Zeichen) innerhalb 
dieses Rechtecks. 


Gespiegelte Abbilder 


Mit der Zeichenbox kann man außer der Skalie- 
rung des Fonts auf eine bestimmte Größe auch 
die Spiegelung von Zeichen an einer waagrech- 
ten oder senkrechten Achse erzielen. Wenn die 
Höhe der Zeichenbox (das Feld cy der Struktur 
SIZEF) negativ ist, werden die Zeichen an der 
Grundlinie gespiegelt und auf dem Kopf stehend 
ausgegeben. Wenn die Breite der Zeichenbox 
(das Feld cx) negativ ist, werden die einzelnen 
Zeichen an der senkrechten Achse gespiegelt. 
Darüber hinaus zeichnet GpiCharStringAt ein 
Zeichen dann von rechts nach links. Das ist so, 
als würde der ganze Zeichenstring an der senk- 
rechten Linie an der linken Seite des ersten Zei- 
chens gespiegelt. 

Die Funktion in VF03.C (Listing 10) zeigt den 
gleichen String viermal an und verwendet dabei 
alle möglichen Kombinationen negativer und 
positiver Zeichenboxwerte. Sie können diese 
Funktion mit dem Menüpunkt »Mirrored Font« 
auswählen. 


Transformationen 


Anders als Bitmapfonts können Vektorfonts auf 
jede beliebige Größe skaliert und in jedem belie- 
bigen Winkel geneigt oder gedreht werden. Dies 
kann mit Matrixtransformationen erzielt werden. 
Darüber hinaus unterstützt das GPI auch meh- 
rere spezielle Funktionen für die Transformation 
von Vektorfonts. Es wurde bereits gezeigt, wie 
die Funktion GpiSetCharBox die Skalierung von 
Fontzeichen ermöglicht. GpiSetCharAngle dreht 
die Fontzeichen und GpiSetCharShear neigt die 
Zeichen. 


Zeichenwinkel und Drehung 


Standardmäßig liegt die Grundlinie eines Vektor- 
fontzeichens parallel zur X-Achse der Weltkoordi- 
naten. Man kann dies mit GpiSetCharAngle 
ändern. Dadurch werden die Zeichen des Vektor- 
fonts gedreht. 

Der Zeichenwinkel wird mit der Struktur 
GRADIENTL angegeben, die aus zwei Feldern 
mit den Namen x und y vom Typ LONG besteht. 
Stellen Sie sich eine Linie vom Punkt (0,0) bis 
zum Punkt (x,y) in Weltkoordinaten vor. Die 
Grundlinie jedes Zeichens liegt parallel zu dieser 
Linie. Die Richtung des Textes entspricht der 
Richtung von (0,0) nach (x,y). 


i* 


VF07.C — Display characters with sheared shadow 
a a er 


#define INCL_GPI 
#include <os2.h> 
#include *vectfont.h" 


vOID Display Shadow (HPS hps, LONG cxClient, LONG cyClient) 
{ 


static CHAR szText[] = "Shadow" ; 
static LONG cbText = sizeof sziext - 1; 
POINTL pt, ptlShear ; 

SIZEF sizfx ; 


CreateVectorfont (hps, LCID_MYFONT, "Tms Rmn Italic*) ; 
GpiSetCharSet (hps, LCID_MYFONT) ; 

ScaleFontToBox (hps, cbText, szText, 3 * cxClient / 4, cyClient) ; 
QueryStartPointinTextBox (hps, cbText, szText, äptl) ; 


ColorClient (hps, cxClient, cyClient, CLR_BLUE) ; 


GpiSavePS (hps) ; 
ptlShear.x = 200 ; 
ptIShear.y = 100 ; 
GpiSetCharShear (hps, &pt1Shear) ; 


// Set char shear 


GpiQueryCharßox (hps, &sizfx) ; 
sizfx.cy #= sizfx.cy/4; 
GpiSetCharßox (hps, &sizfx) ; 


// Set char box 


GpiSetColor (hps, CLR_DARKBLUE) ; 
GpiCharStringAt (hps, &äpti, cbText, szText) ; // Display shadow 
GpiRestorePS (hps, -IL) ; 

6piSetColor (hps, CLR_RED) ; 

GpiCharStringAt (hps, &ptl, chText, szText) ; // Display text 
GpiSetCharSet (hps, LCID_DEFAULT) ; 
GpiDeleteSetId (hps, LCID_MYFONT) ; 
} 


/l Clean up 


Sie können sich dies auch in trigonometischen 
Begriffen verdeutlichen. Die Grundlinie des Tex- 
tes liegt parallel zu einer Linie mit dem Winkel a, 
gegen den Uhrzeigersinn von der X-Achse aus 
gemessen wobei 
a = arctan (y/x) 

ist, und y und x die beiden Felder der Struktur 
GRADIENTL sind. 

Die absolute Größe von x und y sind unwich- 
tig. Wichtig sind die relativen Größen und die 
Vorzeichen. Die Vorzeichen von x und y bestim- 
men die Richtung des Textstrings wie das der 
folgenden Tabelle zu entnehmen ist: 


x y Richtung 

+ + nach oben rechts 
- + nach oben links 

- .- nach unten links 
+ - nach unten rechts 


“Bild 7: 
Zeichenstrings mit 
Schatten durch Zei- 
chenneigung 
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> Bild 8: 
Ausgehöhlte Zeichen 
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VFO8.C 
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sl __' _ BEBEEEEEEEEEETERT © 190 
Di splay 


HOlOW 


/* 


VF08.C — Hollow font 
ee 


#define INCL_GPI 
#include <os2.h> 
#include "vectfont.h" 


vo1D Display_Hollow (HPS hps, LONG cxClient, LONG cyClient) 
{ 


static CHAR szText[] = *“Hollow* ; 
static LONG cbText = sizeof szText - 1; 
POINTL ptl ; 


CreateVectorFont (hps, LCID_MYFONT, "Tms Rmn Italic") ; 
SpiSetCharSet (hps, LCID_MYFONT) ; 

ScaleFontToßox (hps, cbText, szText, cxClient, cyClient) ; 
QueryStartPointInTextBox (hps, cbText, szText, &ptl) ; 


GpiBeginfath (hps, ID_PATH) ; 
6piCharStringAt (hps, Aptl, cbText, szText) ; 
6piEndPath (hps) ; 


/l Text in path 


GpiStrokePath (hps, ID_PATH, OL) ; /l Stroke path 
6piSetCharSet (hps, LCID_DEFAULT) ; 
GpiDeleteSetid (hps, LCID_MYFONT) ; 
} 


/1 Clean up 


Die Funktion in VF04.C (Listing 11) verwendet 
die Funktion GpiSetCharAngle um acht Text- 
strings in 45-Grad-Schritten um den Mittelpunkt 
des Client-Fensters herum anzuzeigen. Bei jedem 
String werden auch die Werte der Struktur 
GRADIENTL, die für den jeweiligen Aufruf ver- 
wendet wurden, mit ausgegeben. 

In diesem Beispiel beginnt der Textstring mit 
einem Leerzeichen, um ein Durcheinander durch 
Überlappen in der Mitte des Client-Fensters zu 
vermeiden. Der Zeichenwinkel beeinflußt die 
Interpretation der Startposition des bei der Funk- 
tion GpiCharStringAt angegeben Strings nicht. 
Wenn Sie Ihren Kopf so drehen, daß ein String 
von links nach rechts läuft, bezeichnet die Start- 
position immer noch den Punkt auf der Grund- 
linie links vom ersten Zeichen. 

Man kann die Zeichen eines Textes an einer 
gekrümmten Linie ausrichten, indem man den 
Startpositionwinkel jedes einzelnen Zeichens 
einzeln berechnet und die Zeichen auch einzeln 
anzeigt. Dies wird in VF05.C gemacht (Listing 
12), um »Hello, World!« auf einer Kreislinie 
anzuzeigen. 

Der Textstring wird abhängig vom Kreisum- 
fang eines Kreises, der einen Radius von der 
Hälfte der Höhe bzw. Breite (der kleinere Wert) 
des Client-Fensters hat, im Mittelpunkt des Fen- 


sters skaliert. Die Funktion GpiQueryWidthTable 
wird dazu verwendet, die Breite der einzelnen 
Zeichen abzufragen und sie um den Kreis herum 
zu verteilen. 


Zeichenneigung 


Man kann Zeichenwinkel leicht mit Zeichennei- 
gung verwechseln, deshalb eine kurze Beschrei- 
bung der Unterschiede. Der Zeichenwinkel be- 
zieht sich auf die Orientierung der Grundlinie. 
Wie in den Bildern 4 und 5 zu sehen ist, wird 
Text mit verschiedenen Zeichenwinkeln gedreht, 
jedoch ansonsten nicht verzerrt. 

Die Zeichenneigung beeinflußt die Erschei- 
nungsweise der Zeichen selbst, ganz unabhängig 
von einer Drehung. Bei der Zeichenneigung wer- 
den Zeichen nach links oder rechts geneigt, die 
untere Seite jedes Zeichens bleibt aber parallel 
zur X-Achse. Man kann die Zeichenneigung dazu 
verwenden, kursive Versionen eines Fonts zu er- 
zeugen. 

Um die Zeichenneigung einzustellen, ruft man 
die Funktion GpiSetCharShear auf. Dies Funktion 
benötigt einen Zeiger auf eine Struktur vom Typ 
POINTL, die aus zwei Feldern mit den Namen x 
und y besteht. Stellen Sie sich eine Linie vor, die 
von (0,0) bis (x,y) in Weltkoordinaten gezeich- 
net wird. Die linke und rechte Seite eines Zei- 
chen verlaufen parallel zu dieser Linie. 

Die Funktion in VF06.C (Listing 13) zeigt sie- 
ben Textstrings mit unterschiedlichen Zeichen- 
neigungen an. Sie können diese Funktion starten, 
indem Sie den Menüpunkt »Character Shear« 
wählen. Zu jedem String werden die X- und Y- 
Werte der POINTL-Struktur, die die Zeichennei- 
gung angibt, ausgegeben. 

Die Zeichenneigung wird von der relativen 
Größe und den Vorzeichen der X- und Y-Werte 
der POINTL-Struktur bestimmt. Wenn das Vor- 
zeichen beider Felder gleich ist, neigen sich die 
Zeichen nach rechts; wenn sie verschieden sind, 
neigen sich die Zeichen nach links. Die Zeichen- 
neigung stellt die Zeichen nicht auf den Kopf. So 
hat eine Zeichenneigung mit dem Punkt (100, 
100) den gleichen Effekt wie die mit (-100,-100). 

Der Winkel der rechten und linken Seite der 
Zeichen zur Y-Achse wird manchmal der Nei- 
gungswinkel genannt. Theoretisch kann der Nei- 
gungswinkel bis etwas über -180 Grad (unend- 
liche linke Neigung) und etwas unter +180 Grad 
(unendliche rechte Neigung) reichen; er ist iden- 
tisch mit 
a = arctan (x/y) 

wobei x und y die beiden Felder der POINTL- 
Struktur sind. 

Wenn man eine nicht standardmäßige Zei- 
chenneigung einstellt, übergibt die Funktion Gpi- 
QueryTextBox ein Array von Punkten, die ein 
Parallelogramm (und kein Rechteck mehr) defi- 
nieren. Die Breite der oberen und unteren Seite 


dieser Textbox sind identisch mit der des nicht 
geneigten Textstrings und die Entfernung zwi- 
schen der oberen und unteren Seite bleibt auch 
gleich. 

Man kann die Zeichenneigung dazu verwen- 
den, um einen kursiven Schatten eines Text- 
strings zu zeichnen. Die Funktion VF07.C (Listing 
14) färbt den Hinmtergrund des Fensters blau 
und zeigt den Textstring »Shadow« zweimal an. 
Der erste Aufruf von GpiCharStringAt zeigt den 
Schatten an. Dieser wird in dunklem Blau mit 
positiver Zeichenneigung gezeichnet. Der zweite 
Aufruf von GpiCharStringAt zeigt die Zeichen 
aufrecht in Rot mit einer etwas geringeren Zei- 
chenboxhöhe an. Sie können diese Funktion star- 
ten, indem Sie den Menüpunkt »Font with Sha- 
dow« wählen. 


Eine Kurzeinführung in Pfade 


Um weitere Möglichkeiten der Vektorfonts zu 
untersuchen, ist es notwendig, uns mit GPI-Pfa- 
den vertraut zu machen, die im wesentlichen den 
PostScript-Pfaden entsprechen. Im GPI legt man 
einen Pfad an, indem man zwischen Aufrufen der 
Funktionen GpiBeginPath und GpiEndPath Funk- 
tionen zum Zeichnen von Linien aufruft: 
GpiBeginPath(hps, idPath); 

<... Linienfunktionen aufrufen ...> 
GpiEndPath 

Dies wird Pfadklammer genannt. In OS/2 1.1 
muß idPath auf 1L gesetzt werden. Die Funktio- 
nen, die innerhalb einer Pfadklammer gültig 
sind, sind in der Dokumentation der Presentation 
Manager-Funktionen aufgeführt. 

Die Funktionen, die man innerhalb einer Pfad- 
klammer aufruft zeichnen nichts. Statt dessen 
merkt sich das System den Pfad, der durch diese 
Linien dargestellt wird. Oft umschließen die Lini- 
en, die man als Pfad zeichnet, Bereiche, doch das 
muß nicht sein. 

Nach dem Aufruf von GpiEndPath kann man 

eines von drei Dingen mit dem so erzeugten Pfad 
anstellen: 
°e Man kann GpiStrokePath aufrufen, um die 
Linien zu zeichnen, die den Pfad ausmachen. 
Diese Linien werden mit der geometrischen Lini- 
enbreite, den Linienverbindungen und -enden 
gezeichnet (Beschreibung folgt später). 
°e Man kann GpiFillPath aufrufen, um die von 
dem definierten Pfad eingeschlossenen Bereiche 
zu füllen. Alle offenen Bereiche werden auto- 
matisch geschlossen. Der Bereich wird mit dem 
aktuellen Muster gefüllt. 
° Man kann GpiSetClipPath aufrufen, um die 
vom Pfad eingeschlossenen Bereiche zu einem 
Clipping-Bereich zu machen. Alle offenen Be- 
reiche werden automatisch geschlossen. Nachfol- 
gende GPI-Aufrufe erzeugen ihre Ausgabe nur 
innerhalb der durch den Pfad beschriebenen 
Bereiche. 


sl _________ VEEIEIEEEEERRSHEENEE Rab} 
Display 


Hello! 


/* 


VF09.C — Font with Drop Shadow 
—\ 


#define INCL_GPI 
#include <os2.h> 
#include *"vectfont.h" 


VvoID Display_DropShadow (HPS hps, LONG cxClient, LONG cyClient) 
{ 


static CHAR szText[] = *Hello!" ; 
static LONG cbText = sizeof szText - 1; 
POINTL pti ; 


CreateVectorfont (hps, LCID_MYFONT, "Tms Rmn Italic”) ; 
GpiSetCharSet (hps, LCID_MYFONT) ; 

ScaleFontToßox (hps, cbText, szText, cxClient, cyClient) ; 
QueryStartPointInTextBox (hps, cbText, szText, &ptl) ; 


GpiCharStringAt (hps, &pt!, cbText, szText) ; // Shadow 


ptl.x —= 12; 4 1/6 inch 
ptl.y += 12 ; 


GpiSetColor (hps, CLR_BACKGROUND) ; 
GpiCharStringAt (hps, &ptl, cbText, szText) ; /l Text string 
GpiBeginpath (hps, ID_PATH) ; 
GpiCharStringAt (hps, &ptl, cbText, szText) ; 
GpiEndPath (hps) ; 


/1 Outline 


GpiSetColor (hps, CLR_NEUTRAL) ; 
GpiStrokePath (hps, ID_PATH, OL) ; 


GpiSetCharSet (hps, LCID DEFAULT) ; /l Clean up 


GpiDeleteSetid (hps, LCID_MYFONT) ; 
} 


Jede dieser Funktionen bewirkt, daß der Pfad 
gelöscht wird. Vor dem Aufruf einer dieser drei 
Funktionen kann man noch die Funktion Gpi- 
ModifyPath aufrufen, die ich gegen Ende dieses 
Artikels beschreiben werde. 

Normalerweise sind GpiCharStringAt und die 
anderen Textausgabefunktionen innerhalb einer 
Pfadklammer nicht gültig. Die einzige Ausnahme 
besteht dann, wenn ein Vektorfont in den Prä- 
sentationsbereich gewählt wird. GpiCharStringAt 
zeichnet den Textstring dann nicht. Statt dessen 
werden dann die Umrisse des Pfads Bestandteil 
des Pfads. 

Die Pfade eröffnen eine ganze Sammlung von 
PostScript-ähnlichen Techniken, die man mit 
Vektorfonts verwenden kann. 


Hohle Zeichen 


Wir wollen damit beginnen, daß wir GpiChar- 
StringAt in einer Pfadklammer aufrufen und 
dann GpiStrokePath verwenden, um die Linien 


“Bild 9: 
Zeichen mit hinter- 
legtem Schatten 
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> Bild 10: 
Massive Blockzeichen 
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VF10.C — Solid block font 
— Si 


#define INCL_GPI 
#include <os2.h> 
#include "vectfont.h" 


VOID Display_Block (HPS hps, LONG cxClient, LONG cyClient) 
{ 


static CHAR szText[] = * Block * ; 
static LONG cbText = sizeof szText - 1; 
INT 1% 

POINTL ptl ; 


CreateVectorfont (hps, LCID_MYFONT, "Tms Rmn Italic") ; 
GpiSetCharSet (hps, LCID_MYFONT) ; 

ScalefontToßox (hps, cbText, szText, cxClient, cyClient) ; 
QueryStartPointinTextBox (hps, cbText, szText, äptl) ; 


ColorClient (hps, cxClient, cyClient, CLR_WHITE) ; 
GpiSetColor (hps, CLR_DARKGREEN) ; 


for (i=0; i<18; ir) 
{ 
GpiCharStringAt (hps, äptl, cbText, szText) ; /1 Block 
pti.x—1; 
ptl.y—1; 
} 


GpiSetColor (hps, CLR_GREEN) ; 


GpiCharStringAt (hps, &äptl, cbText, szText) ; /l Text string 


GpiBeginpath (hps, ID_PATH) ; 


6piCharStringAt (hps, &ptl, cbText, szText) ; /l Outline 
GpiEndPath (hps) ; 

GpiSetColor (hps, CLR_DARKGREEN) ; 

GpiStrokePath (hps, ID_PATH, OL) ; 

GpiSetChar$et (hps, LCID DEFAULT) ; /l Clean up 


GpiDeleteSetid (hps, LCID_MYFONT) ; 
} 


des Pfads zu zeichnen. GpiStrokeAt hat die fol- 
gende Syntax: 
GpiStrokePath(hps, idPath, OL); 

In der ersten Version des Presentation Mana- 
gers muß der letzte Parameter der Funktion auf 
OL gesetzt werden. Wenn man die Funktion ver- 
wendet, um einen mit GpiCharStringAt erzeug- 
ten Pfad zu zeichnen, werden nur die Umrisse 
gezeichnet und nicht das Innere. Dadurch wer- 
den hohle Zeichen erzeugt. 

Die Funktion VF08.C (Listing 15) verwendet 
diese Technik, um die Umrisse der Zeichen des 
Textstrings »Hollow« zu zeichnen. Sie können 
diese Funktion mit dem Menüpunkt »Hollow 
Font« starten. 

Vielleicht möchten Sie die Zeichen in einer 
Farbe und die Umrisse in einer anderen anzei- 
gen. In diesem Fall müssen Sie GpiCharStringAt 


zweimal aufrufen, zunächst um das Innere in 
einer bestimmten Farbe zu zeichnen, und dann 
innerhalb einer Pfadklammer gefolgt von einem 
GpiStrokePath-Aufruf, um den Umriß zu zeich- 
nen. Die Funktion in VF09.C (Listing 16) macht 
etwas ähnliches, um Text mit einem hinterlegten 
Schatten zu zeichnen. 

Der Schatten wird zunächt mit einem norma- 
len GpiCharStringAt-Aufruf gezeichnet. Eine wei- 
tere GpiCharStringAt-Funktion zeichnet den Text 
dann noch einmal in der aktuellen Fensterhinter- 
grundfarbe 1/6 Zoll gegenüber dem ersten String 
versetzt. Dieser Text wiederum wird mit einem 
Umriß umgeben, der mit einem dritten GpiChar- 
StringAt-Aufruf innerhalb einer Pfadklammer 
und gefolgt von GpiStrokePath erzeugt wird. 

Ganz ähnlich verläuft die Erzeugung von Zei- 
chen, die wie massive Blöcke aussehen, wie das 
mit der Funktion in VF10.C gemacht wird 
(Listing 17). Es werden 18 Zeichenstrings jeweils 
um einen Punkt versetzt in der Farbe 
CLR_DARKGREEN gezeichnet. Darüber wird der 
Zeichenstring noch einmal in CLR_GREEN ge- 
zeichnet und der Rand in CLR_DARKGREEN. 


Den Pfad füllen 


Bei der Vorstellung der Pfade habe ich erwähnt, 
daß man eines von drei Dingen mit Pfaden 
machen kann: zeichnen, füllen oder für das Clip- 
ping verwenden. Lassen Sie uns zum zweiten 
übergehen, zum Füllen des Pfads. Um einen Pfad 
zu füllen ruft man diese Funktion auf: 

GpiFillPath(hps, idPath, 10ption); 

Dadurch wird der Pfad mit dem aktuellen 
Muster gefüllt. Alle offenen Bereiche werden vor 
dem Füllen automatisch geschlossen. Der Para- 
meter lOption kann entweder FPATH_ALTER- 
NATE oder FPATH_WINDING sein, um den Pfad 
im alternativen oder im Winding-Modus zu 
zeichnen. Bei Vektorfonts bewirkt FPATH-WIN- 
DING, daß das Innere einiger Buchstaben, zum 
Beispiel des O, gefüllt wird; Sie werden deshalb 
wahrscheinlich FPATH_ALTERNATE verwenden 
wollen. 

Wenn das aktuelle Füllmuster für Bereiche 
PATSYM_ SOLID ist, bewirken folgende Aufrufe 
GpiBeginPath(hps, idPath); 
GpiCharStringAt(hps, &ptl, cch, szText); 
GpiEndPath(hps); 
GpiFillPath(hps, idPath, FPATH_ALTERNATE); 

bei einem Vektorfont nahezu dasselbe, wie 
GpiCharStringAt selbst. Bei der Verwendung 
wird man das Muster auf einen anderen Wert als 
PATSYM_SOLID einstellen. (Ein Fehler in 05/2 
1.1 bewirkt, daß das aktuelle Muster bei einer 
Pfadklammer, in der GpiCharStringAt aufgerufen 
wird, auf PATSYM_SOLID zurückgesetzt wird. 
Man kann diesen Fehler umgehen, indem man 
nach Beendigung des Pfads GpiSetPattern auf- 
ruft.) 


Die Funktion in VF11.C (Listing 18) verwendet 
GpiFillPath, um den Textstring »Fade« achtmal 
hintereinander mit den acht GPI-Schraffur- 
mustern (PATSYM_DENSEl bis PATSYM _- 
DENSE8) zu zeichnen. Schließlich wird dann 
noch GpiCharStringAt einmal außerhalb der 
Pfadklammer aufgerufen. Sie können diese Funk- 
tion mit dem Menüpunkt »Fading Font« aufrufen. 


Geometrisch dicke Linien 


Auf den ersten Blick sieht es so aus, als gäbe es 
keinen Unterschied zwischen dem Zeichnen einer 
Linie in dieser Weise: 

GpiMove(hps, &ptlBeg); 

GpiLine(hps, &ptlEnd); 

und dem Aufruf der beiden gleichen Funktio- 
nen innerhalb einer Pfadklammer und dem an- 
schließenden Zeichnen des Pfads auf diese 
Weise: 

GpiBeginPath(hps, idPath); 
GpiMove(hps, &ptlBeg); 
Gpiline(hps, &ptlEnd); 
GpiEndPath(hps); 
GpiStrokePath(hps, idPath, 0); 

Es gibt jedoch ganz bedeutende Unterschiede. 

Zum einen hat eine mit der normalen GpiLine- 
Funktion gezeichnete Linie eine sogenannte 
»kosmetische« Linienbreite. Die Standardbreite 
der Linie hängt von der Auflösung des Ausgabe- 
geräts ab. Bei einer normalen Linie handelt es 
sich um eine geräteabhängige Breite. Die Breite 
der Linie ändert sich nicht, wenn man Matrix- 
transformationen verwendet, um unterschied- 
liche Skalierungsfaktoren für den Koordinaten- 
bereich einzustellen. Es gibt zwar im GPI eine 
Funktion namens GpiSetLineWidth für die Ver- 
änderung der kosmetischen Linienbreite, diese ist 
jedoch in der MS OS/2 Version 1.1 noch nicht 
implementiert. 

Eine Linie, die durch Zeichnen einen Pfads ge- 
zogen wird, hat jedoch eine geometrische Breite. 
Dies ist eine Linienbreite (in Weltkoordinaten), 
die mit der Funktion GpiSetLineWidthGeom ein- 
gestellt wird. Da diese Linienbreite in Weltkoor- 
dinaten angegeben wird, wird sie von jeder Ska- 
lierung beeinflußt, die man über Matrixtransfor- 
mationen einstellt. 

Zum zweiten kann eine mit GpiLine gezeich- 
nete Linie verschiedene Linientypen aufweisen, 
die mit der Funktion GpiSetLineType eingestellt 
werden. Bei diesen Linientypen handelt es sich 
um verschiedene Kombinationen von Punkten 
und Strichen. Die Linie wird mit der aktuellen 
Linienfarbe und der aktuellen Linienmischung 
gezeichnet. 

Eine Linie, die durch Zeichnen eines Pfads ge- 
zogen wird, verwendet jedoch den Linientyp 
nicht. Die Linie wird statt dessen als ein Bereich 
behandelt, der dem Pfad der Linie folgt, jedoch 
eine geometrische Breite hat. 
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VF11.C — Neon font using geometrically-thick lines 


/* 


*/ 


#define INCL_GPI 
#include <os2.h> 
#include *vectfont.h* 


vOID Display_Neon (HPS hps, LONG cxClient, LONG cyClient) 
{ 
static CHAR szText[] = * Neon * ; 


static LONG cbText = sizeof szText - 1 ; 
static LONG IForeColor[] = { CLR_DARKRED, CLR_DARKRED, CLR_RED, 


CLR RED, CLRWHITE, CLRWHITE 1; 
static LONG IBackColor[] = { CLR_ BLACK, CLR_DARKRED, CLR_DARKRED, 
CLR RED,  CLR RED,  CLRWHITE }; 


static LONG IWidth[] = { 34, 28, 22, 16, 10,4} ; 


INT ilndex ; 
POINTL ptl ; 


CreateVectorFont (hps, LCID_MYFONT, "Tms Rmn Italic*) ; 
GpiSetCharSet (hps, LCID_MYFONT) ; 

ScaleFontToBox (hps, cbText, szText, cxClient, cyClient) ; 
QueryStartPointInTextBox (hps, cbText, szText, äptl) ; 


ColorClient (hps, cxClient, cyClient, CLR_BLACK) ; 


for (ilndex = 0 ; ilndex < 6 ; ilndex+*) 
{ 
GpiBeginpath (hps, ID_PATH) ; 
GpiCharStringAt (hps, &ptl, cbText, szText) ; 
GpiEndPath (hps) ; 


/l Text out 


GpiSetColor (hps, IForeColor[ilndex]) ; 
6piSetBackColor (hps, 1BackColor[iindex]) ; 
GpiSetBackMix (hps, BM_OVERPAINT) ; 


GpiSetPattern (hps, PATSYM_HALFTONE) ; 
6piSetLineWidthGeom (hps, IWidth[iindex]) ; 
GpiStrokePath (hps, ID_PATH, OL) ; /I Stroke path 
} 

GpiSetChar$et (hps, LCID_DEFAULT) ; 
GpiDeleteSetid (hps, LCID_MYFONT) ; 
} 


/l Clean up 


Dieser Bereich wird mit dem Muster gefüllt, 
das mit GpiSetPattern eingestellt wurde und wird 
mit den aktuellen Vorder- und Hintergrundfar- 
ben und der aktuellen Mustervorder- und -hinter- 
grundmischung gefärbt. 

Zum dritten kann eine Linie, die durch Zeich- 
nen eines Pfads gezogen wird, verschiedene Lini- 
enverbindungen und -enden haben. Durch Aufruf 
der Funktion GpiSetLineJoin kann man angeben, 
daß Linien mit runden, eckigen oder zackigen 
Verbindungen aufeinandertreffen. Mit GpiSet- 
LineEnd kann man runde, eckige oder flache 
Linienenden angeben. 

Die Funktion in VF12.C (Listing 19) demon- 
striert die Verwendung geometrisch dicker Linien 
in Verbindung mit Mustern, um den Buchstaben 
eine Art Neoneffekt zu geben. 


“Bild 11: 

Mit verschiedenen 
Mustern gefüllte Zei- 
chen 


«Listing 17: 
VF11.C 
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» Bild 12: 
Neon-Zeichen durch 
Verwendung von 
dicken Linien 


»> Bild 13: 
Farbige Linien in 
einem Textstring 
geclippt 


» Listing 18: 
VF12.C 


>> Listing 19: 
VF13.C 
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VF12.C — Fading font with various pattern densities 


a; 


#define INCL_GPI 
#include <os2.h> 
#include "vectfont.h" 


VOID Display_Fade (HPS hps, LONG cxClient, LONG cyClient) 
{ 
static CHAR szText[] = "Fade" ; 
static LONG cbText = sizeof szIext - 1; 
LONG lPattern ; 
POINTL pti ; 


CreateVectorfont (hps, LCID_MYFONT, "Tms Rmn Italic") ; 
GpiSetCharSet (hps, LCID_MYFONT) ; 

ScaleFontToßox (hps, cbText, szText, cxClient, cyClient) ; 
QueryStartPointInTextBox (hps, cbText, szText, &ptl) ; 


GpiSetBackMix (hps, BM_OVERPAINT) ; 


for (lPattern = 8 ; IPattern >= I ; IPattern—) 

{ 

GpiBeginPath (hps, ID_PATH) ; 
GpiCharStringAt (hps, Aptl, chText, szText) ; 


GpiEndPath (hps) ; 


IH Text out 


GpiSetPattern (hps, IPattern) ; 

Gpifillpath (hps, ID_PATH, FPATH_ALTERNATE) ; /1 FiN path 
ptl.x #= 2; 

ptl.y-—2; 

} 


GpiSetPattern (hps, PATSYM_SOLID) ; 
GpiSetBackMix (hps, BM_LEAVEALONE) 5 
GpiCharStringAt (hps, Aptl, cbText, szText) ; 1 Solid 
6piSetCharSet (hps, LCID_DEFAULT) ; 
GpiDeleteSetid (hps, LCID_MYFONT) ; 
} 


/I Ciean up 


Sie können diese Funktion durch Auswahl des 
Menüpunkts »Neon Effect« starten. Die Funktion 
zeichnet den Pfad unter Verwendung verschie- 
dener geometrischer Linienbreiten gefüllt mit 
einem PATSYM_HALFTONE-Muster und mehre- 
ren Farben. Der Umriß des Fonts ist weiß, er 
wird jedoch von einem roten Schein umgeben. 


Clipping innerhalb von 
Textzeichen 


Die dritte Möglichkeit nach der Anlage eines 
Pfads besteht in einem Aufruf von GpiSetClip- 
Path: 

GpiSetClipPath(hps, idPath, 10ption); 

Der Parameter lOption kann entweder 
SCP_ RESET (was OL entspricht, also der Stan- 
dard ist) oder SCP_AND sein. Mit der Option 
SCP RESET wird der Clipping-Pfad zurückge- 


VF13.C — Clipped Spokes 
* 
/ 


#define INCL_GPI 
#include <os2.h> 
#include <math.h> 
#include *vectfont.h" 


VoID Display_Spokes (HPS hps, LONG cxClient, LONG cyClient) 
l 
static CHAR szText[] = "WOW" ; 
static LONG cbText = sizeof szText - 1; 
static LONG IColors[] = { CLR_BLUE, CLR_GREEN, CLR_CYAN, 
CLR RED, CLR_PINK, CLR YELLOW, 
CLR WHITE } ; 


double dMaxRadius ; 
INT 1, iNumColors = sizeof IColors / sizeof IColors[0] ; 
POINTL ptl ; 


CreateVectorFont (hps, LCID_MYFONT, "Tms Rmn") ; 
GpiSetCharSet (hps, LCID_MYFONT) ; 

ScaleFontToBox (hps, cbText, szText, cxClient, cyClient) ; 
QueryStartPointInTextBox (hps, cbText, szText, &ptl) ; 


ColorClient (hps, cxClient, cyClient, CLR_BLACK) ; 
GpiBeginpath (hps, ID_PATH) ; 


GpiCharStringAt (hps, Aptl, cbText, szText) ; 
GpiEndPath (hps) ; 


/} Text string 


GpiSetClipPath (hps, ID_PATH, SCP_AND | SCP_ALTERNATE) ; 


dMaxRadius = sqrt (pow (cxClient / 2.0, 2 
pow (cyClient / 2.0, 2. 
// Draw spokes 
for (i =0 ; i < 360 ; i®) 
{ 


6piSetColor (hps, IColors[i % iNumColors]) ; 


ptl.x = cxClient / 2; 
ptl.y = cyClient / 2; 
GpiMove (hps, Spt!) ; 


pti.x += (LONG) (dMaxRadius * cos (i * 6.28 / 360)) ; 
ptl.y += (LONG) (dMaxRadius * sin (i * 6.28 / 360)) ; 
Gpiline (hps, &ptl) ; 

} 


GpiSetCharSet (hps, LCID_DEFAULT) ; 
GpiDeleteSetid (hps, LCID_MYFONT) ; 
} 


/ Clean up 


setzt, so daß kein Clipping auftritt. Mit der 
Option SCP_AND wird der neue Clipping-Pfad 
auf die Schnittmenge des alten Clipping-Pfads 
und des gerade in der Pfadklammer definierten 
Pfads eingestellt. Alle offenen Bereiche im Pfad 
werden automatisch geschlossen. 

Man kann die Option SCP_AND entweder mit 
SCP_ALTERNATE (Standard) oder SCP_WIN- 
DING kombinieren. Wie bei GpiFillPath werden 
Sie sicherlich den alternativen Modus verwen- 
den, wenn Sie mit Vektorfonts arbeiten. 

Die Funktion in VF13.C (Listing 20) ruft Gpi- 
CharStringAt mit dem Textstring »WOW« inner- 
halb einer Pfadklammer auf. Darauf folgt ein 
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44 Bild 14: 
Farbige Wellen im 
Text geclippt. 


= er Po 


«Bild 15: 
Farbige Linien im 
Outline geclippt 
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VF14.C — Clipped wavy spline curves 
”/ 


#define INCL_GPI 
#include <os2.h> 
#include <stdlib.h> 
#include "vectfont.h" 


VOID Display Wavy (HPS hps, LONG cxClient, LONG cyClient) 
{ 
static CHAR szText[] = "Hello!" ; 
static LONG chText = sizeof szText - 1; 
static LONG IColors[] = { CLR_BLUE, CLR GREEN, CLRCYAN, CLR_RED, 
CLR PINK, CLR YELLOW, CLR WHITE } ; 
INT 1; Ri = 3 
POINTL ptl, apti[8] ; 


CreateVectorfont (hps, LCID_MYFONT, "Tms Rmn Italic") ; 
GpiSetChar$et (hps, LCID_MYFONT) ; 

ScaleFontToßox (hps, cbText, szText, cxClient, cyClient) ; 
QueryStartPointInTextBox (hps, cbText, szText, &ptl) ; 


ColorClient (hps, cxClient, cyClient, CLR_BLACK) ; 
GpißeginPath (hps, ID_PATH) ; 


GpiCharStringAt (hps, &ptl, cbText, szText) ; 
GpiEndPath (hps) ; 


/l Text string 


GpiSetClipPpath (hps, ID_PATH, SCP_AND | SCP_ALTERNATE) ; 


for (ki =0; i<14; i#) 
{ 


apti[0]).x = 0; 
aptI1[0].y = i * cyClient / 14; 
apt![1].x = cxClient / 3; 


aptI[1].y = min (cyClient, 2 * i * cyClient / 14) ; 


aptl[2].x =» 2 * cxClient / 3; 
aptl[2].y = max (OL, (2 * i - 14) * cyClient / 14) ; 


apt1[3].x = cxClient ; 
apti[3].y = i * cyClient / 14 ; 


apt![4].x = cxClient ; 


apti[4].y = (i + 1) * cyClient / 14; 


apti[5).x = 2 * cxClient / 3; 


aptI[5].y = max (OL, (2 * (i + 1) - 14) * cyClient / 14) ; 
aptI[6].x = cxClient / 3; 

apt1[6).y = min (cyClient, 2 * (i + 1) * cyClient / 14) ; 
apti[7].x = 0; 


apt1[7].y = (1 + 1) * cyClient / 14 ; 


GpiSetColor (hps, IColors[i % 7]) ; 
GpiBeginArea (hps, BA_BOUNDARY | BA_ALTERNATE) ; 


GpiMove (hps, apt]) ; 
GpiPolySpline (hps, 3L, aptl + 1) ; 
Gpiline (hps, apt| + 4) ; 
GpiPolySpline (hps, 3L, apt! +5) ; 
Gpiline (hps, apt)) ; 


/I Splines 


GpiEndArea (hps) ; 

} 
GpiSetCharSet (hps, LCID_DEFAULT) ; 
GpiDeleteSetId (hps, LCID_MYFONT) ; 
} 


// Clean up 


Aufruf von GpiSetClipPath. Der Clipping-Pfad be- 
steht dann aus dem Inneren der Buchstaben. Die 
Funktion zeichnet eine Reihe von farbigen 


44 Listing 20: 


j* VF14.C 
VF15.C — Clipped Spokes 
7 «Listing 21: 
#define INCL_GPI VF15.C 
#include <os2.h> 
#include <math.h> 
#include "vectfont.h* 
VOID Display _ModSpokes (HPS hps, LONG cxClient, LONG cyClient) 
{ 
static CHAR szText[] = "WOW" ; 
static LONG cbText = sizeof szText - 1; 
static LONG IColors[] = { CLR_BLUE, CLR_GREEN, CLR_CYAN, 
CLR_RED, CLR_PINK, CLR_YELLOW, 
CLR_WHITE 5; 
double dMaxRadius ; 
INT i, iNumColors = sizeof IColors / sizeof IColors[0] ; 
POINTL ptl ; 
CreateVectorfont (hps, LCID_MYFONT, "Tms Run") ; 
GpiSetCharSet (hps, LCID_MYFONT) ; 
ScaleFontToBox (hps, cbText, szText, cxClient, cyClient) ; 
QueryStartPointInTextdox (hps, cbText, szText, äpt!) ; 
ColorClient (hps, cxClient, cyClient, CLR_BLACK) ; 
GpißeginPath (hps, ID_PATH) ; 
GpiCharStringAt (hps, Apti, cbText, szText) ; // Text string 
GpiEndPath (hps) ; 
GpiSetLineWidthGeom (hps, 6L) ; /1 1/12 inch 
GpiModifyPath (hps, ID_PATH, MPATH_STROKE) ; 
GpiSetClipPath (hps, ID_PATH, SCP_AND | SCP_ALTERNATE) ; 
dMaxRadius = sqrt (pow (cxClient / 2.0, 2.0) + 
pow (cyClient / 2.0, 2.0)) ; 
// Draw spokes 
for (i =0 ; i< 360 ; it) 
GpiSetColor (hps, IColors[i % iNumColors]) ; 
ptl.x = cxClient / 2; 
ptl.y = cyClient / 2; 
6piMove (hps, Spt!) ; 
ptl.x += (LONG) (dMaxRadius * cos (i * 6.28 / 360)) ; 
ptl.y += (LONG) (dMaxRadius * sin (i * 6.28 / 360)) ; 
6piline (hps, Aptl) ; 
} 
GpiSetCharSet (hps, LCID_DEFAULT) ; // Clean up 
GpiDeleteSetid (hps, LCID_MYFONT) ; 
} 
Linien, die von der Mitte des Client-Fensters aus- 
gehen. Die Funktion VF14.C (Listing 20) verwen- 
det eine ähnliche Technik, zeichnet jedoch eine 
Reihe von Bereichen, die durch Splines definiert 
werden. 
Veränderung des Pfads 
Zwischen dem Aufruf von GpiEndPath zur Been- 
digung des Pfads und dem Aufruf von GpiStroke- 
Path, GpiFillPath oder GpiSetClipPath kann man 
noch GpiModifyPath aufrufen. Diese Funktion 0S/2 PM 
Microsoft 
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verwendet die aktuelle geometrische Linienbrei- 
te, -verbindung und das Linienende um jede 
Linie im Pfad in eine neue Linie umzuwandeln, 
die einen Bereich um die alte Linie einschließt. 
Nehmen wir zum Beispiel an, daß der Pfad eine 
einzige gerade Linie enthält. Nach GpiModify- 
Path würde der Pfad aus einer geschlossenen 
Linie in der Form eines Hot Dogs bestehen. Die 
Breite dieses Hot Dogs ist die geometrische Lini- 
enbreite. Die Enden des Hot Dogs können rund, 
eckig oder flach sein, abhängig vom aktuellen 
Linienende. 

Nach der Anlage eines Pfads sind diese beiden 
aufeinanderfolgenden Funktionen: 
GpiModifyPath(hps, ID_PATH, MPATH_STROKE); 
GpiFillPath(hps, ID-PATH, FPATH_WINDING); 

in der Regel identisch mit: 

GpiStrokePath(hps, ID_PATH, OL); 

GpiModifyPath und GpiStrokePath sind die 
beiden einzigen Funktionen, die die geometri- 
sche Linienbreite, -verbindungen und -enden ver- 
wenden. 

Theoretisch kann man GpiStrokePath nach 
GpiModifyPath aufrufen: 

GpiModifyPath(hps, ID-PATH, MPATH_STROKE); 
GpiStrokePath(hps, ID_PATH, OL); 

Das sollte eigentlich zu etwas führen, und es 
müßte auch sehr interessant sein, doch das GPI 
meldet in der Regel nur, daß es den Pfad nicht 
erzeugen kann, da er zu komplex ist. 

Wir wollen uns statt dessen GpiModifyPath ge- 
folgt von GpiSetClipPath ansehen. Die Funktion 
in VF15.C (Listing 22) ist fast identisch mit der in 
VF13.C (Listing 20); der Unterschied besteht 
darin, daß hier die geometrische Linienbreite auf 
6 eingestellt (1/2 Zoll) und GpiModifyPath vor 
GpiSetClipPath aufgerufen wird. 

Beachten Sie, daß die farbigen Linien nicht 
innerhalb des Inneren der Zeichen sondern 
innerhalb des Umrisses geclippt werden. Durch 


GREENPEACE 


GpiModifyPath sind die Umrisse der Zeichen 
selbst in einen Pfad von 1/12 Zoll Dicke umge- 
wandelt worden. Das ist der Pfad, der für das 
Clipping verwendet wird. 


Reicht es? 


Ich denke, es ist deutlich geworden, daß die 
Möglichkeiten, die das GPI für die Arbeit mit 
Vektorfonts bietet denen von PostScript entspre- 
chen, ja sie teilweise sogar übertreffen. Die GPI- 
Schnittstelle ist sehr leistungsfähig und vielseitig. 

Reicht das? Nein, das ist noch nicht genug. Die 
Implementierung der Vektorfonts im GPI weist 
noch einen strukturellen Fehler auf, so daß Post- 
Script weiter an der Spitze bleibt. 

Werfen Sie noch einmal einen gründlichen 
Blick auf Bild 1 und die Anzeige des Helv-Fonts. 
Sie werden feststellen, daß die beiden Füße des 
Hs sich in der Breite um einen Punkt unterschei- 
den, obwohl sie eigentlich gleich breit sein soll- 
ten. Dies beruht unzweifelhaft auf einem 
Rundungsfehler. Es fällt natürlich auf einem 
Bildschirm mit geringer Auflösung deutlicher auf 
als auf einem 300-Dpi-Laserdrucker, doch selbst 
auf einem Laserdrucker beeinträchtigen solche 
Fehler die Lesbarkeit von Text. 

Solche Fehler treten bei PostScript-Fonts nicht 
auf. PostScript-Fonts sind echte Algorithmen, die 
Anomalien in der Darstellung von Zeichen er- 
kennen und korrigieren können. Im Gegensatz 
dazu werden GPI-Fonts (die als einfache Serie 
von Polylines und Polyfills codiert sind) ohne 
jedes Feedback und ohne Korrekturmöglichkeit 
blind gezeichnet. 

Wenn wir uns also auch an dem erfreuen kön- 
nen, was das GPI zu bieten hat, gibt es immer 
noch die Notwendigkeit für Verbesserungen. 
Charles Petzold 
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Keine Angst vor kleinen Tieren: 


Die Maus 
unter OS/2 


Keine Angst vor kleinen Tieren, 
auch wenn das Tierchen für Sie 
zur unbekannten Art zählt. Von 
der Maus ist oft im Zusammen- 
hang mit komplexen Bedienerober- 
flächen wie dem Presentation 
Manager von OS/2 die Rede, aber 
das Gerät ist einfach und die 
Systemaufrufe von OS/2 für die 
Maus sind nicht schwieriger als die 
für die Tastatur. 


E.:: am System angeschlossene Maus steht 
allen Screen Groups zur Verfügung. In 
Screen Groups des Presentation Managers be- 
treibt dieser die Maus für alle Programme. In den 
anderen Screen Groups bleibt es den Pro- 
grammen überlassen, ob sie die Maus öffnen und 
benutzen. 

Der Ablauf läßt sich in drei Phasen gliedern. 
Zuerst öffnet ein Programm die Maus und fragt 
ihre Charakteristika ab; dann bereitet es sie für 
die Benutzung vor. Schließlich liest es während 
des Programmlaufs die Mausereignisse der Reihe 
nach ein und wertet sie aus. 


Die Funktionsweise der Maus 


Die Maus ist ein kleines Kästchen mit Tasten, das 
man auf dem Schreibtisch herumschiebt. Die 
Maushardware erfaßt die Bewegung mechanisch 
oder optisch und meldet sie dem Computer. 


Mausinterrupts und Mausereignisse 
Wenn die Maus merkt, daß der Operator sie ver- 
schiebt bzw. eine ihrer Tasten drückt oder los- 
läßt, meldet sie das dem Computer mit einem 
Interrupt. 

Die Verarbeitung des Interrupts übernimmt ein 
Maustreiber, der die Eingaben der Maus einliest 
und prüft, was passiert ist. Diese Information legt 
er in einer FIFO-Warteschlange für Mausereig- 
nisse ab. Jede Screen Group hat ihre eigene 
Mauswarteschlange. Der Maustreiber legt die 
Mausereignisse in die Warteschlange der Screen 
Group, die momentan im Vordergrund ist. 

Er kümmert sich auch um die Position des 
Mauszeigers auf dem Bildschirm. Selbst wenn 
der Zeiger unsichtbar ist, aktualisiert der Maus- 
treiber ständig seine Position. Jede Screen Group 
hat einen eigenen Zeiger; der Zeiger der Screen 
Group im Vordergrund wird aktualisiert. 


Mauseinheiten 

Die kleinste Bewegung, die eine Maus erfaßt, 
heißt Mickey. Wie lang ein Mickey im Verhältnis 
zu unseren Standardlängeneinheiten ist, variiert 
je nach Empfindlichkeit der Maus. OS/2 enthält 
einen Systemaufruf, der die Anzahl der Mickeys 
pro Zentimeter der aktuellen Maus liefert. Meine 
Microsoft Busmaus hat 8 Mickeys pro Zentime- 
ter. 

Wenn die Maus eine Positionsänderung von 
mindestens einem Mickey registriert, meldet sie 
das dem Computer mit einem Interrupt. Je nach- 
dem, ob sie am Systembus hängt oder am seriel- 
len Port, unterbricht sie den Computer direkt 
oder schreibt ein Byte in den seriellen Port, der 
dann den Interrupt auslöst. 

Da ein Mickey ziemlich klein ist, gibt es viele 
Interrupts und viele Mausereignisse. Wenn man 
die Maus aber schnell in einem Zug verschiebt, 
faßt entweder die Maus oder der Maustreiber 
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»> Bild 1: 

Die Hot Key-Defini- 
tion des Session 
Managers aus Mou- 
GetHotKey 
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mehrere Mickeys zusammen und meldet nur ein 
Ereignis. 

Wo das geschieht, ist egal. Aufgrund der Viel- 
zahl der Mäuse und Methoden sollte man Maus 
und Treiber immer als Einheit mit absehbarem 
Verhalten ansehen. 


Der Mauszeiger 

Der Maustreiber aktualisiert die Koordinaten der 
Zeiger aller Screen Groups. In welcher Einheit 
die Koordinaten festgelegt werden, hängt vom 
Darstellungsmodus ab. Im Textmodus wird der 
Zeiger nach Zeilen und Spalten plaziert, im Gra- 
fikmodus nach Pixelzeilen und -spalten. Der Zei- 
ger bleibt in allen Modi immer innerhalb des 
Bildschirms. 


Die Zeiger-Zeichenroutine 

Bis zu dem Zeitpunkt, wo die Maus eröffnet 
wird, ist die Zeigerposition nur eine logische 
Position, man sieht sie auf dem Bildschirm nicht. 
Erst wenn ein Programm die Maus öffnet, kann 
es einen sichtbaren Zeiger anfordern. Von da an 
ruft der Maustreiber die Zeichenroutine nach 
jeder Positionsänderung des Zeigers auf. 

Die Zeichenroutine muß als Unterroutine des 
Maustreibers laufen. Aus technischen Gründen 
muß sie selber als Gerätetreiber geladen werden 
(mit einer device=-Anweisung in der Konfigura- 
tions-Datei). Die Standard-Zeigerzeichenroutine 
heißt POINTDD.SYS und wird als Gerät namens 
POINTER$ geladen. Man kann auch andere Zei- 
chenroutinen verwenden, aber das Basissystem 
hat nur eine. 


Der Zeiger im Textmodus 

Im Textmodus wird der Mauszeiger als Zeichen- 
zelle dargestellt, normalerweise mit invertierten 
Vorder-/Hintergrundfarben. Wenn der Operator 
die Maus verschiebt, ruft der Treiber die Zei- 
chenroutine auf, den Zeiger zu löschen und an 
der neuen Position in den Bildschirmpuffer zu 
zeichnen. 

Dazu wird das Attributbyte einer Zeichenzelle 
im Bildschirmpuffer verändert. Leider weiß der 
Scrolling-Code nichts vom Mauszeiger. Wenn der 
Bildschirm unter dem Zeiger durchserollt, scrollt 
die Zeichenzelle mit den invertierten Farben 
munter mit, und landet in einer anderen Zeile. 
An der ehemaligen Position des Zeigers steht da- 
nach ein anderes Zeichen. 

Umgekehrt weiß die Zeigerzeichenroutine 
nichts vom Scrolling. Wenn sie das nächste Mal 
aufgefordert wird, den Zeiger zu löschen und 
neu zu zeichnen, sieht sie nur, daß die Zelle, wo 
der Zeiger war, sich geändert hat. Sie sucht sich 
also die neue Zeigerzelle und ändert deren Far- 
ben. Beim Scrolling entsteht eine Folge von Zei- 
gerzellen auf dem Bildschirm, deshalb muß man 
den Mauszeiger vor dem Scrollen ab- und hinter- 
her wieder einschalten. 
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kein Hot-Key 


Der Zeiger im Grafikmodus 

Die Zeigerzeichenroutine in Version 1.0 arbeitet 
nur im Textmodus. Im Grafikmodus erscheint 
einfach kein Zeiger. Mögliche Lösungen siehe 
unten. 


Den Zeiger aussperren 
Das Programm kann Rechtecke in Größen zwi- 
schen einem Pixel und der Größe des Bildschirms 
definieren, in denen der Mauszeiger nicht ge- 
zeichnet wird. Die Position des Zeigers wird 
aktualisiert, aber wenn er in dem gesperrten Be- 
reich landet, wird er nicht gezeichnet; er ver- 
schwindet am Rand des Bereichs und erscheint 
auf der anderen Seite wieder. Bewegt man den 
Zeiger schnell, sieht es aus, als ob er unter dem 
gesperrten Bereich hindurchgeleitet — der Bereich 
scheint solide und undurchsichtig. 

Wenn man einen rechteckigen Bildschirmaus- 
schnitt scrollt und den Zeiger aus dem Bereich 
ausschließt, wird er nicht mitgescrollt. 


Die Maus eröffnen 


Die Maus steht jedem Prozeß zur Verfügung, er 
muß sie nur öffnen. Der Treiber, der die »echte« 
Maus steuert, erzeugt für jede Screen Group mit 
MouOpen eine virtuelle Maus — eine Pseudomaus 
aus Zeigerposition und Warteschlange. 

MouOpen eröffnet den Zugriff auf die Maus. 
Er übernimmt den Namen einer Zeigerzeichen- 
routine und liefert eine Handle, die die Maus in 
andere Operationen repräsentiert. Außerdem 
initialisiert MouOpen die Maus auf einen neu- 
tralen Status. 


Ist eine Maus angeschlossen? 
Möglicherweise ist keine Maus angeschlossen. 
OS/2 braucht keine Maus und es gibt viele maus- 
lose Systeme. Wenn keine Hardwaremaus exi- 
stiert oder der Treiber nicht geladen wurde, lie- 
fert MouOpen einen Fehlercode. 

Die Maus ist Teil der Screen Group, aber man- 
che Prozesse gehören zu keiner — Programme, 
die mit Abkoppelungs-Befehl gestartet wurden, 
mit run= in der Konfigurations-Datei oder mit 
DosExecPgm, Option 4 (abgekoppelte Ausfüh- 
rung). Solchen Programmen liefert MouOpen 
einen Fehlercode. 

In der Screen Group des Presentation Mana- 
gers hat MouOpen sowieso nichts zu sagen und 
liefert vermutlich auch einen Fehlercode. Der 
Presentation Manager steuert die Maus für alle 
Programme, die in seinen Fenstern laufen. 
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Mausereignisse Warteschlange wird benutzt 
melden Mickeys Blocklesen 
Zeiger nicht zeichnen Warteschlange leeren 


nicht unterstützter 
Darstellungsmodus 


Kurz gesagt, ein Programm muß davon aus- 
gehen, daß MouOpen einen Fehlercode ungleich 
Null liefern kann. Wenn das eintritt, muß das 
Programm mit dem Operator auf anderem Wege 
kommunizieren. 


Eine Zeichenroutine wählen 

MouOpen übernimmt als Eingabeparameter den 
Namen der Zeigerzeichenroutine. Das ist meist 
ein far-Zeiger (ein Doppelwort mit Nullen), was 
zeigt, daß das Programm den Standardsystem- 
zeiger verwendet. Alternativ dazu kann es die 
Adresse eines Zeichenstrings POINTER$ ange- 
ben, die den Namen der Standard-Zeigerzeichen- 
routine enthält, die als POINTDD.SYS geladen 
wird. 

Version 1.0 kann mit den Grafikmodi nichts 
anfangen. Für Programme im Textmodus ist das 
kein Problem, aber für solche im Grafikmodus. 

Man könnte (1) eine Ersatzzeichenroutine 
schreiben, die Pixelgrafik verträgt. Die Routine 
muß bei der Konfiguration als Gerätetreiber ge- 
laden werden, dann kann man MouOpen den 
Gerätenamen, den sie definiert, angeben. Die 
Zeigerzeichenroutine arbeitet als direkte Unter- 
routine des Maustreibers. Der Treiber ruft sie bei 
einem Interrupt auf. Genau wie andere Treiber 
muß auch diese Routine im Real und Protected 
Modus laufen und wird vermutlich in Assembler 
geschrieben. Das ist nichts für Leute mit schwa- 
chen Nerven. 

Man kann (2) das Zeichnen des Zeigers auch 
dem Programm überlassen. Das Programm liest 
und interpretiert die Mausereignisse sowieso, 
deshalb ist die Aktualisierung eines kleinen Bild- 
schirmausschnitts bei Mausbewegungen keine 
große Belastung. Es dauert zwar eine Weile, die 
Mausbewegung in der Ereigniswarteschlange zu 
melden, aber der Operator nimmt die Verzöge- 
rung kaum wahr. 

Die dritte Lösung wäre ein Mausmonitor. Mehr 
dazu finden Sie im Buch im Kapitel über Moni- 
tore. 


Der Anfangsstatus 

Beim Öffnen wird die Maus initialisiert, der Zei- 
ger auf eine Position in der Bildschirmmitte (bei 
Zeile 12/Spalte 40 in einer normalen 80x25-Dar- 
stellung) gesetzt und der ganze Bildschirm ge- 
sperrt, so daß ein Programm den Mauszeiger erst 
anfordern muß, bevor er sichtbar wird. Der Zei- 
ger hat anfänglich die Standardform (im Text- 
modus invertierte Farben). Die Ereignismaske, 
die festlegt, welche Ereignisse in die Warte- 
schlange eingetragen werden, wird so eingestellt, 


daß alle möglichen Ereignisse eingetragen wer- 
den. Dann wird die Warteschlange geleert. 


Die Maus vorbereiten 


Nachdem die Maus geöffnet wurde, möchte das 
Programm wissen, was die Maus kann und den 
Gerätestatus, die Zeigerform und den Proportio- 
nalitätsfaktor einstellen. 


Alles über die Maus 

Verschiedene Systemaufrufe liefern Information 
über die Maus. MouGetNumßButtons meldet die 
Anzahl der Mausknöpfe (eins, zwei oder drei). 
Das läßt sich auch in der Maske aus MouGet- 
EventMask erfahren. 

Die Empfindlichkeit der Maus erfährt man mit 
MouGetNumMickeys, der angibt, wieviele Mic- 
keys pro Zentimeter gemessen werden. Das hilft 
einem beim Einstellen des Proportionalitätsfak- 
tors. 

Möglicherweise reserviert der Session Mana- 
ger bestimmte Tastenkombinationen als Hot 
Keys. MouGetHotKey liefert die Bitmap aus 
Bild 1. Wenn Bit 0 in dem Wort gesetzt ist, sind 
keine Tastenkombinationen reserviert und die 
Anwendung kann alle Maustasten nutzen. Wenn 
Bit O Null ist, zeigt die Kombination der anderen 
Bits, welche Tastenkombinationen der Session 
Manager reserviert hat. 


Den Gerätestatus abfragen 

und einstellen 

MouGetDevStatus liefert ein Wort mit Statusbits, 
siehe Bild 2. Die Bits 0, 1 und 2 sind für Anwen- 
dungen nahezu uninteressant. 

Anders Bit 3. Es wird gesetzt, wenn die 
Zeigerzeichenroutine nicht mit dem aktuellen 
Darstellungsmodus klarkommt. In Version 1.0 
von OS/2 wird das Bit nach MouOpen gesetzt, 
wenn ein Grafikmodus eingestellt ist. 

Wie so oft in OS/2, wird auch der Mausstatus 
mit einem komplementären Aufrufpaar gepflegt. 
MouSetDevStatus übernimmt das Wort, das 
MouGetDevStatus liefert. Man holt sich also den 
Status, ändert die relevanten Bits und setzt ihn 
neu. 

Nur zwei der Bits aus Bild 2 kann man setzen 
— Bit 8 verhindert permanent oder vorüber- 
gehend, daß der Zeiger gezeichnet wird. Soll der 
Zeiger wieder gezeichnet werden, muß man das 
Bit löschen. Mit Bit 9 wählt man zwischen zwei 
Meldearten. Darüber sprechen wir weiter hinten. 


Den Proportionalitätsfaktor abfragen 

Der Gerätetreiber wird bei jeder horizontalen 
oder vertikalen Bewegung der Maus benachrich- 
tigt. Da ein Mickey sehr klein ist, erhebt sich die 
Frage, ab wievielen Mickeys die Zeigerposition 
auf dem Bildschirm angepaßt werden soll. 


44 Bild 2: 
Die Statusbits des 
Mausgeräts 
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> Bild 3: 

Die Datenstruktur 
von MouGet/Set- 
ScaleFact 


>> Tabelle 1: 
Die Auswirkungen 
der AND- und XOR- 


Masken auf ein Bild- 


bit 


> Bild 4: 

Die Datenstruktur 
von MouGet/SetPtr- 
Shape 
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00h Mickeys pro Spalte 
02h Mickeys pro Zeile 


Die Antwort hängt vom Darstellungsmodus 
und den Vorstellungen des Operators ab. Der 
Proportionalitätsfaktor gibt das Verhältnis zwi- 
schen Mickeys und der Bewegung des Zeigers auf 
dem Bildschirm an. MouGetScaleFact liefert den 
Proportionalitätsfaktor in der Struktur aus Bild 3. 

Die beiden Werte geben an, um wieviele Mic- 
keys sich die Maus bewegen muß, damit der 
Mauszeiger eine Einheit verschoben wird. In 
Textmodi initialisiert MouOpen den Proportio- 
nalitätsfaktor der Microsoft Busmaus auf 16 Mic- 
keys pro Zeile und 8 Mickeys pro Spalte. Die 
Maus muß 16 Mickeys in vertikaler Richtung 
melden, 2 cm, bevor der Treiber den Zeiger ver- 
tikal um eine Zeile verschiebt. 

MouSetScaleFact ist die Komplementärrou- 
tine; sie übernimmt die Struktur aus Bild 3 und 
stellt den Proportionalitätsfaktor ein. 

Größere Proportionalitätsfaktoren machen die 
Maus unempfindlicher, kleinere machen sie 
»lebendiger«. Die Koordinationsfähigkeit zwi- 
schen Auge und Hand variiert von Mensch zu 
Mensch — manche Benutzer können den Maus- 
zeiger anfänglich kaum auf einen bestimmten 
Punkt des Bildschirms bringen. Später lernen es 
die meisten. Ich bin selber so ein Zappelphilip 
und mir ist die Standardeinstellung zu empfind- 
lich. Wenn man die Werte verdoppelt, läßt sich 
die Sache einfacher handhaben. Der Benutzer 
sollte die Möglichkeit haben, den Faktor nach 
seinen Wünschen zu ändern. 


00h Größe der Bilddaten in Bytes (im Textmodus 4) 
02h Breite des Zeigers in Spalten (im Textmodus 1) 
04h Höhe des Zeigers in Zeilen (im Textmodus 1) 
06h Hot-Spot-Pixelspalte (im Textmodus 0) 

08h Hot-Spot-Pixelzeilen (im Textmodus 0) 


Die Zeigerform abfragen und einstellen 
Das Bild des Mauszeigers wird durch ein paar 
Bildbytes plus der Information in der Struktur 
aus Bild 4 definiert. Die Bilddaten des Zeigers 
lassen sich mit MouGetPtrShape abfragen, egal 
ob der Zeiger gezeichnet wird oder nicht. 

MouGetPtrShape liefert die Bildbytes in einen 
Puffer und füllt die oben gezeigte Struktur aus. 
Der Komplementäraufruf heißt MouSetPtrShape 
- er übernimmt dieselben, eventuell aktualisier- 
ten, Parameter und installiert sie. 

Zum Verständnis der Zeigerdaten muß man 
eines berücksichtigen: Das Bild des Zeigers er- 
setzt die Bildschirmdaten nicht. Es wird gezeich- 
net, indem man die Bildschirmdaten an der Zei- 
gerposition modifiziert. Die Bildbytes spezifizie- 
ren die Art der Modifizikation. 

Der Mauszeiger wird gezeichnet, indem man 
Zeigerbildbytes mit Bytes auf dem Bildschirm 


ANDet und andere Bytes mit dem Ergebnis des 
AND XORt. Die Kombination der Verfahren er- 
möglicht vier Ergebnisse, siehe Tabelle 1. 

Jedes Bit auf dem Bildschirm, das unter dem 
Zeiger zu liegen kommt, kann auf Null oder Eins 
gesetzt, bewahrt oder invertiert werden. Die 
Bildbytes aus MouGetPtrShape beinhalten eine 
AND-Maske in der Größe des Zeigerbildchens, 
gefolgt von einer XOR-Maske derselben Größe. 


Das Zeigerbild im Textmodus 
MouOpen initialisiert das Bild des Textzeigers 
auf vier Byte: 
ffh ffh 00h 77h 

Die AND-Maske enthält lauter Einser-Bits. Das 
erste Byte der XOR-Maske enthält lauter O-Bits, 
die Bits des Zeichenbytes in der Zelle werden 
(gemäß Tabelle 1) bewahrt. 


Bit der XOR-Maske Null Eins 
Bit der Null Null Eins 
AND-Maske Eins bewahrtinvertiert 


Das zweite XOR-Byte invertiert die drei Bits 
aller Farben. Wenn die Farben Null und Sieben 
(Weiß auf Schwarz) sind, sind es hinterher Sie- 
ben und Null. Das erzeugt nicht etwa inverse 
Zeichen, sondern einen weißen Block. Bessere 
Ergebnisse erzielt man durch XORen des zweiten 
Bytes mit 7fh, das invertiert die Helligkeit und 
die Farbe des Vordergrunds und so gut wie jedes 
Zeichen bleibt unter dem Zeiger sichtbar, egal 
welche Originalfarben es hatte. 


Das Zeigerbildchen im Grafikmodus 

Im Grafikmodus (vorausgesetzt, der Zeigerzei- 
chencode unterstützt das) wird die Zeigergröße 
in Pixeln im zweiten und dritten Feld von Bild 4 
angegeben. In dem Fall ist die Form der AND- 
und XOR-Masken nicht genau definiert. Die Bits 
in den Masken entsprechen den Pixels des Bild- 
chens, wahrscheinlich Zeile für Zeile geordnet. Es 
ist nicht bekannt, ob jede Zeile bis zu einer Byte- 
grenze ausgefüllt werden muß. Es scheint 
logisch, aber ich konnte es nicht ausprobieren. 

Wenn der Grafikmodus mehrere Bitplanes 
(Bitebenen) erfordert wie die erweiterten Modi 
von EGA und VGA, gibt es für jede Bitplane ein 
Maskenpaar in Reihe. 

Im Grafikmodus ist das Bild meist größer als 
ein Pixel (die Einheit, in der die Koordinaten 
angegeben werden). Es stellt sich also die Frage, 
an welcher Stelle relativ zu der in den Koordina- 
ten angegebenen Position der Zeiger gezeichnet 
werden soll. Die letzten beiden Felder aus Bild 4 
beantworten die Frage. Sie definieren den soge- 
nannten Hot Spot in relativen Pixelzeilen und 
Spalten innerhalb des Zeigerbildchens. Dieser 
Hot Spot wird genau auf dem Pixel, das die Zei- 
gerkoordinaten angeben, gezeichnet, das rest- 
liche Bild drum herum. 


00h Zeilennumer oben links 
02h Spaltennummer oben links 
04h Zeilennmmer unten rechts 
O6h Spaltennummer unten rechts 


Den Zeiger sichtbar machen 

und aussperren 

Der letzte Vorbereitungsschritt für die Arbeit mit 
der Maus besteht darin, den Zeiger sichtbar zu 
machen. MouOpen sperrt den Zeiger ja anfäng- 
lich aus dem gesamten Bildschirm aus. Mou- 
DrawPtr löscht gesperrte Bereiche. Der Zeiger 
wird — vorausgesetzt, es ist im aktuellen Darstel- 
lungsmodus möglich und durch die Gerätestatus- 
bits erlaubt — auf dem Bildschirm gezeichnet und 
folgt den Mausbewegungen. 

Mit MouRemovePtr läßt sich der Zeiger aus 
Bereichen aussperren. Er wird nicht völlig ge- 
löscht, sondern nur in diesen Bereichen nicht ge- 
zeichnet. MouRemovePtr übernimmt die Daten- 
struktur aus Bild 5. 

In frühen OS/2-Versionen war die Struktur 
ungenau dokumentiert. Bild 5 zeigt die Struktur 
richtig: die Felder 00h und 02h enthalten die 
Koordinaten der linken oberen Ecke, 04h und 
06h die der unteren rechten Ecke. Die Ecken 
müssen innerhalb der Grenzen des aktuellen Dar- 
stellungsmodus liegen. 
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Bewegung u. Taste 


00h verschlüsseltes Ereignis 

02h Tisestaup in Millisekunden 

04h Mauszeile oder relative vertikale Mickeys 
06h Mausspalte oder relative horizontale Mickeys 


Benutzung der Maus 


Sobald die Vorbereitungen abgeschlossen sind, 
muß das Programm nur noch auf Mausereignisse 
warten. Wie Sie wissen, legt der Gerätetreiber 
jedes Mausereignis in einer Warteschlange ab, 
aus der sich das Programm informiert. Auf den 
Disketten zu diesem Buch finden Sie ein Pro- 
gramm, das die Maus vorbereitet, auf Ereignisse 
wartet und die Ereignisse auf dem Bildschirm 
wiedergibt. 


Ereignisse lesen 

MouReadEventQue liefert das nächste Ereignis 

aus der Warteschlange in der Struktur aus Bild 6. 
Die Bitmask des ersten Wortes gibt Aufschluß 

über die Art des Ereignisses. Die Bits können in 


jeder Kombination vorkommen oder alle Null 
sein. Das weist übrigens nicht auf das Fehlen 
eines Ereignisses hin, sondern bedeutet, daß eine 
gedrückte Taste losgelassen wurde. 


Ereignisse selektieren 

Möglicherweise interessieren eine Anwendung 
nur bestimmte Ereignisse, beispielsweise nur 
Bewegungen mit gedrückter Taste. MouGet- 
EventMask liefert ein Wort im Format der Ereig- 
nismaske aus Bild 6 mit einer -1 für jedes mög- 
liche Ereignis. MouOpen setzt in der Maske jedes 
Ereignis, das die angeschlossene Maus erzeugen 
kann. Wenn die Maus nur eine oder zwei Tasten 
hat, werden die Ereignisbits für die fehlenden 
Tasten auf Null gesetzt. 

Man kann die Maske, die MouGetEventMask 
liefert, ändern und mit MouSetEventMask aktua- 
lisieren. Unabhängig von den Ereignissen in der 
Warteschlange aktualisiert aber der Treiber stän- 
dig die Mausposition und zeichnet den Zeiger 
(falls zugelassen). 


Der Ereignis-Timestamp 

Die 32-Bit Timestamp im zweiten Feld ist eine 
Kopie des Millisekundentimers des Systems. Sie 
gibt den Zeitpunkt an, zu dem das Ereignis in der 
Warteschlange abgelegt wurde. Der Millisekun- 
denzähler wird bei jedem Timertick oder alle 32 
Millisekunden aktualisiert. 

Anwendungen verwenden die Timestamp 
meist zur Bestimmung des Intervalls zwischen 
zwei Mausereignissen, indem sie die erste Time- 
stamp von der zweiten subtrahieren und das Er- 
gebnis durch 32 teilen (um fünf Bits nach rechts 
shiften). Genauigkeit geht nicht verloren und 
man kann das Ergebnis normalerweise in einem 
nicht vorzeichenbehafteten 16-Bit-Wort spei- 
chern. Wenn der Operator zwischen zwei Ereig- 
nissen zum Mittagessen geht, überschreitet das 
Intervall das »Ausdrucksvermögen« eines Wortes. 
Wenn solche langen Intervalle für das Programm 
wichtig sind, kann man Intervalle, die das Fas- 
sungsvermögen von 16 Bits übersteigen, in 
65535 umwandeln und als unendlich bezeich- 
nen. 


Die Ereignisposition 
Die letzten beiden Felder in Bild 6 enthalten 
Positionsinformation, gewöhnlich die Zeigerkoor- 
dinaten zu dem Zeitpunkt, wo das Ereignis ein- 
getreten ist (also am Ende einer Bewegung). 
Wurde Bit 9 des Gerätestatusbytes gesetzt (mit 
MousSetDevStatus), spiegeln die Ereignisdaten 
die relativen Mickeys der Bewegung wider. In 
dem Fall enthalten die Felder vorzeichenbehaf- 
tete Integerzahlen, wobei negative Werte »nach 
oben« oder »nach links« bedeuten, positive »nach 
rechts« oder »nach unten«. Bei diesem Berichts- 
modus werden mehr Ereignisse berichtet. Er eig- 
net sich für Programme, die ihren eigenen Maus- 
zeiger zeichnen. 


44 Bild 5: 

Daten der Sperr- 
bereiche für Mou- 
RemovePtr 


44 Bild 6: 

Die Ereignisdaten- 
struktur aus Mou- 
ReadEventQue 
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> Bild 7: 

Die Datenstruktur 
aus MouGetQue- 
Status 


>> Bild 8: 

Die Datenstruktur 
aus MouGet/Set- 
PtrPos 
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00h Anzahl der Elemente in der Warteschlange 
02h Maximale Warteschlangenkapazität aus Konfigurations-Datei 


Den Warteschlangenstatus prüfen 

Mit MouGetNumQueEl findet ein Programm her- 
aus, wie viele Ereignisse in der Warteschlange 
gespeichert sind. Der Aufruf liefert die beiden 
Worte aus Bild 7. Das erste Wort zeigt, wie viele 
Ereignisse in der Warteschlange liegen, das 
zweite gibt an, wie viele hineinpassen. Diese 
Größe wird in der Konfigurations-Datei einge- 
stellt. 

In einem schwach ausgelasteten System hat 
ein Programm keine Schwierigkeiten, die Maus 
zu überwachen. Die Auslastung des Systems und 
die verfügbare CPU-Zeit eines Programms läßt 
sich aber nicht vorhersehen. Eine Anwendung 
sollte deshalb die Warteschlange prüfen und falls 
sie mehr als dreiviertel voll ist, die Priorität des 
Threads, der die Mausereignisse verarbeitet, er- 
höhen. 

Mit MouFlushQue läßt sich die Warteschlange 
leeren. MouOpen tut das auch, deshalb ist die 
Warteschlange am Anfang leer, aber Programme 
müssen den Vorgang eventuell wiederholen, 
wenn sie den Arbeitsmodus oder das Bildschirm- 
format ändern. 


Die Zeigerposition ändern 

Wenn die Mausereignisse mit ihren absoluten 
Koordinaten gemeldet werden, weiß das Pro- 
gramm immer, wo der Zeiger steht. Werden sie 
aber in relativen Mickeys gemeldet, muß es die 
absolute Zeigerposition mit MouGetPtrPos abfra- 
gen. Der Aufruf meldet die aktuellen Zeigerkoor- 
dinaten in der Struktur aus Bild 8. 

MouGetPtrPos meldet unter Umständen eine 
Position weit von der vorherigen Position des 
zuletzt gelesenen Ereignisses. Selbst wenn Mou- 
GetPtrPos direkt nach MouReadEventQue aufge- 
rufen wird, kann das Programm zwischen zwei 
Mausereignissen für einen unbekannten Zeit- 
raum eingefroren gewesen sein. In einem 
schwach ausgelasteten System wird das Intervall 
kurz sein, aber ein Programm kann nicht voraus- 
setzen, daß es in leicht ausgelasteten Systemen 
läuft. Wenn die Koordinaten eines Ereignisses 
wichtig sind, müssen sie in der Ereignisaufzeich- 
nung gemeldet werden. 

Mit MouSetPtrPos kann ein Programm neue 
Zeigerpositionen angeben. Der Aufruf übernimmt 
die Struktur aus MouGetPtrPos. 


Die Maus schließen 


Wenn ein Programm die Maus nicht mehr 
braucht, kann es die Handle mit MouClose für 
anderweitige Nutzung freigeben. Beim Prozeß- 
ende wird MouClose automatisch aufgerufen, 
wenn die Maus zu dem Zeitpunkt offen ist. 


Mausfunktionen ersetzen 


Die meisten Mausaufrufe des Systems kann man 
durch eigenen Code ersetzen. Der Ersatzcode 
übernimmt die Funktion des ersetzten Codes für 
die gesamte Screen Group. Ersetzt werden kön- 
nen die Aufrufe aus Tabelle 2. Von dieser Mög- 
lichkeit machen meist Programme wie der Pre- 
sentation Manager von OS/2 Gebrauch, die die 
Ausführungsumgebung anderer Programme ver- 
walten. 

Man nennt den Vorgang »einen Ersatz eintra- 
gen« (engl. register). Eingetragen wird mit Mou- 
Register, ausgetragen mit MouDeRegister. Man 
kann mehr als eine Ersatzfunktion auf einmal 
eintragen, aber es darf immer nur je ein einge- 
tragener Aufruf innerhalb einer Screen Group 
laufen. 


00h Zeilennummer 
02h Spaltennumer 


Der Code aller ersetzten Aufrufe liegt in einer 
einzelnen Prozedur, deren Eintrittspunkt bei 
jedem Aufruf einer der ersetzten Funktionen 
irgendwo in der Screen Group aufgerufen wird. 
Den Stackaufbau dabei zeigt Bild 9. 

Das Klientenprogramm, das die Mausfunktion 
aufruft, übergibt ihr Stackparameter. Unterhalb 
der Parameter liegt die Rücksprungadresse des 
Klienten, dann zwei Worte, die der Mausrouter 
(der Code, der die Mausfunktionsaufrufe abfängt 
und zu den Ersatzaufrufen umleitet) dort ablegt. 
Eins der Worte ist die Indexnummer der ersetz- 
ten Funktion (siehe Tabelle 2). Damit selektiert 
man die Unterprozedur, die eine Funktion wahr- 
nimmt. 

Die Ersatzfunktion wird aufgerufen, wenn ein 
Prozeß in der Screen Group den entsprechenden 
Aufruf tätigt — egal, ob die Screen Group im Vor- 
der- oder im Hintergrund liegt. Andererseits sind 
Prozesse in anderen Screen Groups nicht betrof- 
fen. Sie verwenden die Standardmausaufrufe 
bzw. die Ersatzfunktionen, die in ihren jeweili- 
gen Screen Groups eingetragen sind. 

Ersatzcode unterliegt einer Reihe von Ein- 
schränkungen. Er muß von mehr als einem Pro- 
gramm zugleich betreten werden können — des- 
halb muß er in einer Dynamic Link Bibliothek 
liegen, denn nur Dynamic Link (kurz dynalink) 
Codesegmente können im Adreßraum mehrerer 
Programme liegen. 

Er muß reentrant sein, damit ihn mehr als ein 
Thread auf einmal ausführen kann (er steht ja 
mehr als einem Programm zur Verfügung). Wenn 
er statische Daten verwendet, muß er den Zugriff 
auf die Daten mit Semaphoren ordnen (nicht mit 
kritischen Abschnitten, weil die nur innerhalb 
eines einzelnen Prozesses wirksam sind). 

Das geschieht mit MouSynch, der mit DosSem- 
Request eine Semaphore anfordert, die einer 


Screen Group gehört. Der Router löscht die 
Semaphore, wenn die Ersatzprozedur endet. 
Außerdem darf der Code die ersetzten Maus- 
funktionen selber nicht benutzen und muß deren 
Operationen durch Aufruf des Maustreibers mit 
DevIOCTL oder über direkte Hardwarezugriffe 
aus einem Segment mit I/O-Privileg selber aus- 
führen. Deshalb, aufgrund des variablen Stack- 
aufbaus und der erforderlichen reentrant-Fähig- 
keit wird die Ersatzfunktion vermutlich in As- 
sembler geschrieben. 
David E. Cortesi 


Parameterstack für aufgerufene Funktion 


Indexnummer der ersetzten Funktion 


Offset im Code des Hausrouters 


Rücksprungadresse zum Mausrouter 


1 
m 
== 
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Dieser Artikel ist ein Auszug aus dem »0S/2 Pro- 
grammierhandbuch« von David E. Cortesi, erschie- 


Nummer Funktion 

0 MouGetNumßButtons 
1 MouGetNumMickeys 
2 MouGetDevStatus 
3 MouGetNumQueEl 
4 MouReadEventQue 
5 MouGetScaleFact 
6 MouGetEventMask 
7 MousSetScaleFact 
8 MousSetEventMask 
9 MouGetHotKey 

10 MouSetHotKey 

11 MouOpen 

12 MouClose 

13 MouGetPtrShape 
14 MousSetPtrShape 
15 MouDrawPtr 

16 MouRemovePtr 

17 MouGetPtrPos 

18 MousSetPtrPos 

19 MoulnitReal 

20 MouFlushQue 

21 MousSetDevStatus 


nen im Markt&Technik-Verlag, mit dessen freund- 


licher Genehmigung der Abdruck erfolgt. 


“ Tabelle 2: 

Die Indexnummern 
der ersetzten Maus- 
funktionen 


44 Bild 9: 

Der Stackaufbau 
beim Eintritt in die 
Ersatz-Mausfunktion 


CHIP WISSEN 


Die kompetente Buchreihe rund um den PC 


Hans-Peter Förster/Martin Zwernemann: 


Makroprogramme, Standardformate und 


Musterformulare mit Word 4.0 


144 Seiten, 42 Bilder, Hardcover 

48,— DM (mit 5,25”-Diskette) 

ISBN 3-8023-0246-X 

Jeder der mit Word 4.0 Standardformulare 
ausfüllt, Serientexte schreibt und Etiketten 
bedruckt oder eigene Makroprogramme 
und Druckformatvorlagen erstellen 
möchte, braucht dieses Buch mit Diskette. 


Hans-Joachim Sacht: 


Auf der Diskette befinden sich nahezu alle 
Etikettenformate, Formate für Endlos- 
papiere und Standardformulare. 

Die Makroprogrammierung, 

das Arbeiten mit Druckformaten und 
Serientexten wird Schritt für Schritt 
anhand von Praxis-Beispielen erklärt. 


Programmieren mit QuickBASIC 


4.0 und 4.5 


210 Seiten, 66 Bilder, Harteinband 

mit 5,25-Zoll-Diskette 

48,— DM/ISBN 3-8023-0245-1 

Durch die neuen Microsoft-Compiler 
QuickBASIC 4.0 und 4.5 können so kom- 
fortable und gutstrukturierte Programme 
entwickelt werden, wie es sonst nur mit 
einem leistungsfähigen Interpreter 
möglich war. 


Haben Sie schon den neuen 
„CHIP- Katalog“ ? 
Bestellen Sie gleich! 


Das Buch bietet die vielfältigen Funktio- 
nen in konzentrierter Form und geht vor 
allem auf die Handhabung und Sprachele- 
mente dieses Compilers ein. Programmie- 
rern, die bisher nur mit einem BASIC- 
Interpreter gearbeitet haben, wird erklärt, 
wie sie schnell auf QuickBASIC umsteigen 
und so die Vorteile der Kompilierung aus- 
nutzen können. Eine Diskette mit den im 
Buch behandelten Beispielen liegt bei. 


Vogel Buchverlag 
Postfach 67 40 - 8700 Würzburg 1 
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Auch Windows-Anwender brauchen 
Hilfe: 


Hilfe- 
Verwaltung 
für Windows 


Eine Applikation mit einem inte- 
grierten Hilfe-Modul wird schneller 
erlernt und vielfältiger genutzt und 
letztendlich aufgrund der besseren 
Bedienbarkeit auch öfters verkauft. 
Grund genug, daß jedes Programm 
ein solches Hilfe-Modul besitzen 
sollte. Im folgenden wird eine um- 
fassende Hilfeverwaltung vorge- 
stellt, welche mit verhältnismäßig 
geringem Aufwand in den Quell- 
code einer Windows-Applikation 
eingebunden werden kann. 


bwohl Microsoft im Application-Style-Guide 

des Windows-SDK [1] die Implementierung 
von MDI, Soforthilfe, DDE etc. empfiehlt, wurden 
solche sinnvolle Features in den Standard-Win- 
dows-Applikationen (WRITE, PAINT usw.) bisher 
nicht integriert. Lediglich der PIF-Editor besitzt 
eine (etwas halbherzige) Soforthilfe. Das erste 
Microsoft-Programm, in das eine wirklich gute 
Soforthilfe integriert wurde, ist MS-Excel. 

Ebenso wie bei der MDI-Schnittstelle, die in 
der letzten Ausgabe des System-Journals aus- 
führlich vorgestellt wurde [2], ist es auch bei der 
Soforthilfe sinnvoll, sich an der Excel-Implemen- 
tierung zu orientieren. Obwohl sie an einigen 
Stellen noch Mängel besitzt, ist sie doch ziemlich 
konsistent, vielseitig und leistungsfähig. Bevor 
wir auf die Soforthilfe von Excel eingehen, wol- 
len wir zunächst einmal festhalten, was der Be- 
nutzer eigentlich von einer Soforthilfe erwartet 
und welche Probleme bei der Implementierung 
auftreten. Anschließend wird dann auf die reali- 
sierte Hilfe-Verwaltung eingegangen und ihre 
Schnittstelle beschrieben. Als Anwendungsbei- 
spiel wird dann eine kleine Applikation mit 
Namen SHAPE vorgestellt. Im weiteren Verlauf 
des Artikels wird auf die Implementierung von 
SHAPE und der applikationsunabhängigen Hilfe- 
Verwaltung eingegangen. Abschließend erfolgt 
ein Ausblick auf die Weiterentwicklung der ge- 
zeigten Verwaltung. 


Allgemeine Forderungen 
an Applikationen 


Der professionelle Anwender von Personal-Com- 
putern interessiert sich weniger für technische 
Einzelheiten der Hardware oder der Software; 
für ihn ist der PC weitgehend ein nützliches 
Hilfsmittel zur Lösung seiner Probleme, ähnlich 
wie viele Autofahrer ihr Fahrzeug als ein reines 
Fortbewegungsmittel ansehen und sich nicht 
etwa mit der Einstellung der Ventile beschäftigen 
wollen. So beschränkt sich die Begeisterung des 
professionellen Anwenders beim Einsatz von 
Software meistens auf die Eleganz und Ge- 
schwindigkeit, mit der er seine anstehenden Pro- 
bleme lösen kann. Beispielsweise interessiert es 
den Anwender nicht, daß etwa ein Textverarbei- 
tungsprogramm 50 verschiedene Features für die 
Gestaltung des Seitenlayouts bietet. Ihn interes- 
siert aber inbesondere, daß er mit dem Pro- 
gramm ein augenblicklich benötigtes Seiten- 
layout überhaupt erzeugen kann und wie er dies 
in möglichst kurzer Zeit realisieren kann. Er er- 
wartet, daß ein Programm ihn auf dem Weg zu 
seiner Problemlösung so weit unterstützt, daß 
die vom Programm angebotenen Möglichkeiten 
sein Problem optimal lösen. Dabei muß die 
Suche nach der Lösung so vom Programm unter- 
stützt werden, daß sie nach kurzer Zeit gefunden 
wird. 
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— SHAPE MS-Windows Application 


BERSRSENESERSEIESSSSSEEESSESSEEESENEEEEEEEEESEETEEEEEREETEREEGEETEEnnn 


This MS-Windows application is a small program for the demonstration 
and study of the Help manager. The program permits the drawing of 
simple geometric objects in different colors and shapes. 


Copyright 1989 by 
Marcellus Buchheit, Buchheit software research 
Zaehringerstrasse 47, D-7500 Karlsruhe 1 
Phone (0) 721/37 67 76 (West Germany) 


Release 1.10 of 89-Jul-13 — All rights reserved. 


ee / 


/* define/undefine non-debugging option name */ 
#undef NDEBUG 


#define NOMINMAX 
#include <WINDOWS.H> 
#include *HELPMGR.H" 
#include "DEFS.H" 


/* further C standard headers */ 
#include <STDLIB.H> 
#include <STRING.H> 
#include <STDIO.H> 


/* window function parameter macros */ 
#define P2LO LOWORD(u1P2) 

#define P2HI HIWORD(u1P2) 

#define LADDR(r) (LONG) (LPSTR) (r) 


/* geometric objects */ 

enum 
{08J_NONE„OBJ_ELLIPSE,OBJ_RHOMBUS „0BJ_SECTOR 
l; 

/* color index values */ 


enum 
{COLOR_RED,COLOR_GREEN,COLOR_BLUE 


WORD i0bject=OBJ_NONE; /* object to paint */ 

/* size of object in percent parts of client area */ 
WORD sxübject=50; /* horizontal */ 

WORD syObject=50; /* vertical */ 


/* drawing color of object */ 
DWORD wrogbObject=RGB(0,0,0); /* default is black */ 


/* brushing for filling geometric object */ 
LOGBRUSH wIbrObject={BS_HATCHED,RGB(0,0,0) „HS_BDIAGONAL}; 
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Application Variables 


en / 


BYTE *zAppName="SHAPE"; /* application module name */ 


BYTE *rzAppTitle; /* pointer to application title name */ 
BYTE *rzNoMemory; /* pointer to error string "no memory" */ 
HANDLE hiMain; /* handle to application instance */ 
HANDLE hAccel; /* handle to standard accelerator table */ 
fr 


window handles 


“/ 
HWND hwMain; /* handle to main window */ 
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ErrorNoMem 


The error message "Not enough memory" is displayed in a message box. 

Parameters: 

hw is the window handle of the next active window and NULL if no 
window exists. 


Used variables: 
rzAppTitie is the local handle to the application title name. 
rzNoMemory is the local handle to the no-memory error string. 


Return: 
None 


ee / 


Die im letzten Abschnitt gemachten Äußerun- 
gen klingen selbstverständlich. Dennoch genügen 
viele, auch sehr teuere Programme, diesen An- 
forderungen nicht. Programme verfügen oft über 
viele leistungsfähige Features, die aber nicht ge- 
nutzt werden, weil der Benutzer sie nicht kennt 
oder sie nicht in adäquater Zeit für sein konkre- 
tes Problem anwenden kann. Um solche Pro- 
gramme überhaupt nutzen zu können, sind bei 
der Neuanschaffung von Software Einführungen 
und langwierige, teuere Schulungen der Mitar- 
beiter unvermeidbar. Solche Schulungen über- 
steigen oft den eigentlichen Anschaffungspreis 
der Software um ein Vielfaches, ganz abgesehen 
von dem Arbeitsausfall des Mitarbeiters während 
der Schulung. Daher eine weitere Behauptung, 
die jeden Softwareproduzenten herausfordern 
müßte: Software, die leicht anzuwenden ist und 
dadurch die Einführung und Schulung verkürzt, 
kann zu einem höherem Preis verkauft werden, 
sofern der Anwender Kosten für die Schulung 
einspart. Außerdem: Je schneller und vielseitiger 
ein Anwender eine Applikation benutzen lernt, 
umso schneller und stärker empfiehlt er das Pro- 
gramm seinen Kollegen weiter. 

Fensterorientierte Oberflächen wie MS-Win- 
dows haben bereits die Benutzerakzeptanz er- 
heblich erhöht. Einheitliche Grundbedienung, 
Aufklapp-Menüs, Dialogfelder, die WYSIWYG- 
Darstellung und die Verlagerung »von der Tech- 
nik zum Problem«, etwa bei der Druckausgabe, 
erleichtern dem Benutzer den Umgang und die 
Einarbeitung mit einer neuen Applikation erheb- 
lich. Doch bei der Lösung eines konkreten Pro- 
blems bleibt er ohne weitergehende Features 
weiterhin alleingelassen. Möchte ein Anwender, 
der mit der Windows-Applikation MS-Write nicht 
besonders vertraut ist, in dieser die Randbreite 
ändern, ohne in die Windows-Dokumentation zu 
blicken, muß er alle Aufklapp-Menüs durch- 
suchen, um den dazu erforderlichen Befehl zu 
finden. Erfordert ein Problem die Ausführung 
mehrerer Befehle in bestimmter Reihenfolge 
(beispielsweise: Anlegen eines Inhaltsverzeich- 
nisses in MS-Word), ist dies mit der »Suchmetho- 
de« überhaupt nicht lösbar. Soll der häufige Blick 
in die gedruckte Dokumentation vermieden oder 
reduziert werden, müssen also der Applikation 
weitere Features hinzugefügt werden, die zwar 
nicht zwingend für die Benutzung erforderlich, 
aber in der Praxis eben doch unverzichtbar sind. 
Eines dieser Features ist die Soforthilfe, die im 
Mittelpunkt dieses Artikels steht. 


Anforderungen 
an die Soforthilfe 


Die Soforthilfe ist ein Hilfsmittel für den Benut- 
zer zum Lösen seiner individuellen Probleme. Sie 
enthält Texte, die teilweise ein verkürztes Hand- 
buch darstellen, teilweise aber auch vom Umfang 


44 Listing 1: 

Das Programm 
SHAPE.C mit Aufruf 
der Hilfe-Verwal- 
tung. 
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oder der Präzision der Darstellung dieses errei- 
chen oder gar übertreffen. Aber Information in 
Form von Texten ist wertlos, wenn die Texte un- 
systematisch und ungegliedert sind. So gibt es 
DOS- oder UNIX-Programme, die den Hilfetext 
als eine große, aber unstrukturierte Einheit zum 
Lesen beigefügt haben. Sucht man eine be- 
stimmte Lösung, muß man einen Großteil des 
Textes durchlesen, auch viele augenblicklich un- 
wichtige Stellen. Die Texte in der Soforthilfe 
müssen also so strukturiert werden, daß der An- 
wender mit wenig Aufwand »seinen« gewünsch- 
ten Text findet. Wie muß diese Strukturierung 
aussehen? Nun, ähnlich wie in einem gedruckten 
Handbuch. Die Frage des Benutzers lautet: »Wie 
kann ich mein konkretes Problem lösen?«. Er hat 
für das Problem ein Stichwort (beispielsweise 
»Randeinstellung« oder »Verzeichnis«), sucht 
dies im Register, schlägt die passende Seite in 
der Dokumentation auf und liest sich die ent- 
sprechenden Hinweise durch. 

Auch bei der Soforthilfe ist ein solche Vor- 
gehensweise nützlich. Es existiert ein Index mit 
Schlüsselwörtern, der, wenn möglich, alle Fragen 
umfaßt, die der Benutzer als Problem in 
(Schlüssel-)Worte fassen kann. Der Benutzer 
wählt im Index ein Schlüsselwort aus und erhält 
am Bildschirm sofort den dazu passenden Hilfe- 
text. Die einzelnen Texte sind nicht unzusam- 
menhängend, sondern wie in einem Buch kapi- 
telweise geordnet. Die Soforthilfe sollte den 
sequentiellen Durchgang durch die Texte anhand 
dieser kaptitelweisen Anordnung ermöglichen, 
ähnlich wie ein Benutzer durch ein Buch blättert. 
Hat der Anwender beispielsweise mit dem Stich- 
wort »Randeinstellung« die Lösung für sein Pro- 
blem erfahren, so findet er vielleicht das nächste 
Kapitel »Anordnung von Seitenüberschriften« 
auch ganz nützlich für sein Problem. 

Viele Applikationen realisieren den Index hie- 
rarchisch, es gibt beispielsweise Hauptschlüssel- 
wörter und Unterschlüsselwörter. Nachteilig an 
dieser Methode ist, daß der Benutzer wieder 
nicht weiß, wo er sein Problem suchen soll. Auch 
Register in Büchern sind nicht hierarchisch son- 
dern vollständig linear angeordnet. Bei vielen 
Schlüsselwörtern in einem Hilfe-Index müssen 
natürlich geeignete Zugriffsmaßnahmen auf den 
Index am Bildschirm gegeben werden, etwa 
durch die Eingabe der Anfangsbuchstaben eines 
Schlüsselworts. Der Vorteil eines hierarchischen 
Indexes besteht in der schnellen Übersicht, die 
sich ein Anfänger über das Produkt machen 
kann. Doch sollte dann dieser Index besser 
»Inhaltsverzeichnis« genannt werden, und als 
Alternative zum linearen Index neben diesem 
existieren. 

Zusammenfassend kann also die »Wie«-Sofort- 
hilfe als ein Buch betrachtet werden. Sie kann bei 
entsprechendem Umfang schriftliche Programm- 
beilagen wie Referenzhandbücher ersetzen. Vor- 
teile ergeben sich aus der flexibleren Hand- 


v010 ErrorNoMem(HWND hw) 


{HpmSetMsgBoxEnv(0,0); /* no help activation is possible */ 
MessageBox (hw, rzNoMemory,rzAppTitle,MB_ICONHAND|MB_OK); 
} /* ErrorNoMem() */ 


Je 


PrintError 


The error string with resource value <iString> is displayed at screen 
in a message box. The environment for the help manager is set. 


Parameters: 

1 is the window handle of the next active window and 
NULL if no such window exists. 

iString is the identification of the error string. 

iDigItem is the identification of the message box item which causes 
the error. 


Used variables: 
rzAppTitle is the local handle to the application title name. 


Return: 
None 


Me / 
. 


VOID PrintError(HWND hw,WORD iString,WORD iDIgItem) 
{BYTE z[255]; 


HpmSetMsgBoxEnv(iDlgItem, iString); 
LoadString(hiMain,iString,z,sizeof(z)); 
MessageBox (hw,z,rzAppTitle,MB_ICONASTERISK|MB_OK) ; 
} /* PrintError() */ 


F eteisleiehdeinhdeheieidaishchiuisiaieieiehshdkeieieknishsieieksishdeheisiebsinsieisduiahcelebskiehrieisäsishshsheideidhsheel 
ReadDiIgItemWord 
PLPPPEPEPEPLEPERPEDEDEREOLDELLTLLLLLLPLPEERUEDEERDERERLDLLLLELDLERLERe 
This function reads a numerical unsigned integer value in range 
0..uMax (including) from the "edit" item <iltem> and stores it at 
address <ruDest> if the specification was correct. If so, TRUE is 
returned. 

In case of any error (bad characters specified or overflow), the error 
string STE_NUMVAL is printed in a message box, the input focus is set 
to <iltem, all characters of the field are selected and FALSE is 
returned. 


Parameters: 

hwBox .. is the window handle of the dialog box. 

iltem .. is the item identifier of the edit field. 

ruDest is the address of a WORD variable where the 
read value is stored. 

uMax ... is the maximum value which is permitted. 


Return: 

If the value is specified correctly, it is stored at address [ruDest] 
and 

TRUE is returned. Otherwise FALSE is returned. 


A  / 


B00L ReadDigItemWord(HWND hwBox,WORD iltem,WORD *ruDest,WORD uMax) 


{B00L bTrns; 
WORD u; 


usGetDlgltemInt (hwBox, iltem,&bTrns,FALSE) ; 
if (bTrns 8% u<=uMax) 

{/* no error: store value, return */ 

*ruDest=u; return TRUE; /* no error */ 

I FI 
/* invalid specification or overflow: error message, set focus */ 
Print£rror (NULL,STE_NUMVAL,iItem); 
/* select all characters in item */ 
SendD1gItemMessage(hwBox, iltem,EM SETSEL,0,MAKELONG(0,32767)); 
SetFocus (GetDlgItem(hwBox,iltem)); 
return FALSE; /* error */ 
} /* ReadDigitemkord() */ 
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PaintdlIgiItem 


ESIEREIESTSEIEEEEREIESBESEEENTRSESEHSEIEEEEENBEESESESFESESSESSEREETEnEn 


This function paints the contents of the dialog item <iltem> 
of dialog box <hwBox>. 


Parameters: 
hwBox is the window handle of the dialog box. 
iltem is the item identifier of the field to paint. 


Used variables: 
rzAppTitle is the local handle to the application title name. 


Return: 
None 
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VOID PaintDigItem(HWND hwBox,HWND iltem) 


{HWND hwitem; 
HDC hdc; 

RECT wreItem; 
HBRUSH hbrItem; 


hwItem=GetDlgItem(hnBox,iltem); 

if (IhwItem) return; /* item not available */ 

/* repaint contents of item */ 

GetClientRect (hwItem,äwrcItem); hic=GetDC(hwItem); 
InvalidateRect (hwItem,NULL,TRUE); 

/* specify painting brush */ 

switch (iltem) 

{case IDTHATCH: 
hbrItem-CreateHatchBrush(HS_BDIAGONAL,wrgbübject); 
break; 

case I0TSOLID: 
hbrItem=CreateSol idBrush(wrgbübject); 
break; 

} /* switch */ 

Selectübject (hdc,hbritem); 

/* draw full contents of window with specified brush */ 
Rectangle(hdc,-1,-1,wreltem.right+1,wreItem.bottom+1); 
ReleaseDC(hwitem,hdc) ; DeleteObject (hbritem) ; 

} /* PaintDigItem() */ 
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Dialog-Box functions 
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 Aeleheisinisbsinsinhsickshehsicksinhshsishsletshstaiehsietntnbeheind kalelehelahe nlelchstelebinlehdehdielshehulebaleketsbchlelslehuhl 


tfdSize 
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### Dialog Box function ### 


This function processes any messages received 
by the DBX_SIZE dialog box. 


Parameters: 
standard message data (see fwMain) 


Return: 
standard dialog box function value, DialogBox() returns TRUE. 
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B00L FAR PASCAL fdSize(HWND hw,WORD iMsg,WORD uP1,DWORD ulP2) 
{WORD sx,sy; 


switch (iMsg) 

(case WM_INITDIALOG: 
SetDIgItemInt (hw, IDHORZ,sxObject, FALSE); 
SetDigItemInt (hw, IDVERT,syObject, FALSE); 
return TRUE; /* no focus set */ 

case WM COMMAND: 
switch (uPl) 

{case IDOK: 
/* read values in edit fields */ 
if (!ReadDlgItemWord(hw, IDHORZ,&sx,100)) break; 
if (!ReadDigitemWord(hw, IDOVERT,&sy,100)) break; 
/* store set values */ 
sx0übject=sx; syObject=sy; 
case IDCANCEL: 
/* close dialog box */ 
EndDialog(hw,uPi); 
return TRUE; 
} /* switch */ 
break; 
} /* switch */ 
return FALSE; 
} /* fdSize() */ 
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fdColor 


### Dialog Box function ### 


This function processes any messages received by 
the DBX_COLOR dialog box. 


Parameters: 
standard message data (see fwMain) 


Return: 
standard dialog box function value. DialogBox() returns TRUE. 


re ae / 
B00L FAR PASCAL fdColor(HWND hw,KORD iMsg,WORD uP1,DWORD ulP2) 


tint i; 
static struct 


habung eines elektronischen Handbuchs: Schnel- 
lerer Zugriff, möglicherweise relational über 
mehrere Schlüsselwörter, die Aufnahme von 
benutzereigenen Hilfetexten als eine Art Anmer- 
kung etc. 

Ebenso wie ein Referenzhandbuch auf dem 
Tisch ständig zum Lesen und Suchen verfügbar 
sein sollte, müssen die Texte der Soforthilfe am 
Bildschirm zusätzlich zur eigentlichen Applika- 
tion anzeigbar sein. Die Texte werden daher 
sinnvollerweise in einem unabhängigen Fenster 
angezeigt. Zwar ist bei den heutigen Bildschirm- 
größen nicht viel Platz für beide Darstellungen, 
aber technische Fortschritte auf dem Gebiet der 
Bildausgabe lassen schon in einiger Zeit groß- 
formatige Bildschirme wahrscheinlich machen, 
die solche Probleme vergessen lassen. 


Die Frage nach dem »Was« 


Die Frage nach dem »Wie« ist nicht die einzige 
Art, wie man auf die Soforthilfe zugreifen kön- 
nen möchte. Ein dialogorientiertes Betriebs- 
system zeigt dem Anwender eine Menge Dialog- 
objekte, deren Bedeutung er als Anfänger 
zunächst nicht kennt. Viele davon erlauben ihm 
aber Probleme zu lösen, die er vielleicht als sol- 
che im Rahmen seiner Computer-Anwendung 
noch gar nicht gesehen hat. Andererseits besitzen 
oft »Experten« zu vielen Dialogobjekten ein ge- 
wisses »Halbwissen«: Man kennt zwar die Bedeu- 
tung des Objekts, die Einzelheiten aber hat man 
schon wieder vergessen. Es muß daher einen 
zweiten Zugriff auf die Hilfetexte geben, nämlich 
über die Frage »Was bedeutet dies?«. Der An- 
wender muß das gewünschte Element mit der 
Maus oder Tastatur anklicken und die Hilfever- 
waltung zeigt ihm einen passenden Hilfetext mit 
der Bedeutung des Elements an, gegebenenfalls 
mit Anwendungsbeispielen angereichert. Diese 
Art der Soforthilfe wird häufig als »kontextorien- 
tierte Hilfe« bezeichnet. 

Eine automatische aber verkürzte Anzeige der 
Bedeutung von Befehlen schreibt die IBM-SAA- 
Spezifikation vor: Jede Applikation besitzt am 
unteren Fensterrand eine Statuszeile, die beim 
Auswählen von Befehlen innerhalb eines Auf- 
klapp-Menüs eine kurze Beschreibung des Be- 
fehls anzeigt, die zwar ausführlicher als der Be- 
fehlsname im Menü ist, aber natürlich nicht um- 
fangreichere Hilfetexte ersetzen kann. Dennoch 
ist diese Einzeilen-Darstellung ein nicht zu unter- 
schätzendes Hilfsmittel. 


Die Frage nach dem »Warum« 


Ein weiteres Kapitel von Ärgernissen für Benut- 
zer stellen Fehlermeldungen dar. Angefangen 
von Meldungen für Genies wie »Fehler! Pro- 
gramm beendet« über Meldungen für Gedächnis- 
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künstler wie »Fehler XUA4315« zu so aussage- 
kräftigen Hinweisen wie »Ungültiger Pfad, kein 
Verzeichnis oder Verzeichnis nicht leer« ist alles 
vertreten. Obwohl ein Programm meistens sehr 
genau »weiß«, warum etwas falsch ist, hat der 
Implementierer aus Bequemlichkeit eine detail- 
lierte Ausgabe vernachlässigt. So kann es etwa 
sein, daß man im Handbuch bei der Beschrei- 
bung des Fehlers »XUA4315« mehrere Hinweise 
erhält, wie der Fehler verursacht sein könnte, die 
beim unerfahrenen Benutzer Erinnerungen an 
das Orakel von Delphi auslösen. Obwohl das 
Programm eine detaillierte Fehlerausgabe auf- 
grund seiner Informationen bieten könnte, bleibt 
sie dem Anwender verborgen. Die Soforthilfe 
muß also auch in diesem Fall Unterstüzungen für 
den Benutzer anbieten. 

Bei Windows-Applikationen werden Fehler- 
meldungen in Hinweisfeldern (im Original mes- 
sage boxes) angezeigt. Oftmals ist der kurze Hin- 
weis für den erfahrenen Benutzer ausreichend, 
etwa »Format falsch« oder »Datei nicht gefun- 
den«. Es gibt wenig Sinn, jedesmal eine lang- 
atmige Erklärung aufzuführen, warum etwa das 
Format einer eingegebenen Zahl fehlerhaft ist. 
Doch der Anfänger ist häufig mit den kurzen 
Fehlermeldungen überfordert. Seine Frage 
»Warum dieser Fehler?« sollte von der Hilfever- 
waltung mit ausführlicheren Sätzen erläutert 
werden, wobei im Idealfall auf die tatsächlichen 
Ursachen des Fehlers eingegangen wird. Eine 
detaillierte und vollständige Unterstützung des 
Anwenders in solchen Fragen erleichtert die Ein- 
arbeitung in ein neues Programm erheblich. 
Auch das die Software entwickelnde Unterneh- 
men wird entlastet, wenn typische Fragen und 
Antworten an die »Hotline« von Anfang an in die 
Soforthilfe übertragen werden. 


Heutige Realisierungen 
von Soforthilfen 


Nach dem etwas ausführlichen Ausflug in die 
Ergonomie der Soforthilfe soll kurz untersucht 
werden, inwieweit die Soforthilfe bereits bei 
heute verfügbaren Applikationen integriert ist. 
Unabhängig von MS-Windows lassen sich bei der 
Soforthilfe die Applikationen weitgehend in fol- 
gende vier Klassen einteilen: 

® Programme ohne jede Soforthilfe. Hierzu zäh- 
len beispielsweise DOS-Command, MS-Write und 
alle DOS-Systemprogramme. 

« Programme mit ein »bißchen« Soforthilfe. 
Hierbei werden einige wenige Hinweise auf die 
Möglichkeiten der Applikation gegeben, bei- 
spielsweise welche Befehle vorhanden sind oder 
wie Parameter von Befehlen angegeben werden 
müssen. Zu solchen Applikationen zählen bei- 
spielsweise PC-Tools (Version 4) oder Norton- 
Utilities. 

® Programme mit ausführlichen Hilfetexten, die 


{int vColor; 
HWND hw; 
} 
Entry[3]; 
BYTE z[5]; 
DWORD ul; 
int vColor; 


switch (iMsg) 

(case WM_INITDIALOG: 
ulewrobübject; /* current set color */ 
for (i=COLOR_RED;i<=COLOR BLUE; i+*) 

(/* set scroll range, scroll value and percent values */ 
Entry[i].vColor=(100*(BYTE)uL+128) /255; 
ul>>=8; /* move to next color */ 
Entry[i] .hw=GetDlgItem(hw, IDRED+i) ; 
sprintf(z,"%d%%" ‚Entry[i].vColor); 
SetDigItemText (hw, IDVRED+i ,z); 
SetScrollRange(Entry[i].hw,S8_CTL,0,100, FALSE); 
SetScrollPos(Entry[i].hw,SB_CTL,Entry[i].vColor, TRUE); 

} /* for */ 

return TRUE; /* no focus set */ 
case WM_CTLCOLOR: 
switch (GetWindowhord(P2LO,GWW_1D)) 
{case IDTRED: 
SetTextColor(uP1,RGB(255,0,0)); break; 
case IDTGREEN: 
SetTextColor(uP1,RGB(0,255,0)); break; 
case IDTBLUE: 
SetTextColor(uP1,RGB(0,0,255)); break; 
default: 
return NULL; 
} /* switch */ 
return (BOOL)GetStockübject (NULL _BRUSH); 
case WM_HSCROLL: 
for (T=COLOR RED; 1<=COLOR BLUE; I++) 
{if (P2HIt=Entry[i].hw) continue; 
vColor=Entry[i].vColor; 
switch (uPl) 
{case SB_TOP: 
vColor=0; break; 

case SB_BOTTOM: 
vColor=100; break; 

case SB_LINEUP: 
if (vColor!=0) vColor—; 
break; 

case SB_LINEDOWN: 
if (vColor<100) vColort+t; 
break; 

case SB_PAGEUP: 
if (vColor>10) vColor-=10; else vColor=0; 
break; 

case SB_PAGEDOWN: 
if (vColor<90) vColor+=10; else vColor=100; 
break; 

case SB_THUMBPOSITION: 

case SB_THUMBTRACK: 
vColor=P2L0; break; 

} /* switch */ 

if (vColor!=Entry[i].vColor) 

{/* set new values */ 
Entry[i].vColorevColor; 
SetScrollPos(Entry[i].hw,SB_CTL,vColor, TRUE); 
sprintf(z,"td%*" Entry[i].vColor); 
SetDIgItemText (hw, IDVRED+i ,z); 

| BED da 4 

} /* for */ 

break; 
case WM COMMAND: 
switch (uPl) 
{case IDOK: 
/* store set color values */ 
wrobübject=RGB 
((Entry[COLOR_RED] .vColor*255+50)/100, 
(Entry[COLOR_GREEN] .vColor*255+50)/100, 
(Entry[COLOR_BLUE] .vColor*255+50)/100 


wIbrübject.1bColor=wrobübject; 
case IDCANCEL: 
/* close dialog box */ 
EndDialog(hw,uPi); return TRUE; 
} /* switch */ 
break; 
} /* switch */ 
return FALSE; 
} /* fdColor() */ 
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fdßBrush 
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### Dialog Box function ### 


This function processes any messages received by 
the DBX_BRUSH dialog box. 


Parameters: 
standard message data (see fnMain) 


Return: 
standard dialog box function value. DialogBox() returns TRUE. 
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B00L FAR PASCAL fdBrush{HWND hw,WORD iMsg,WORD uP1,DWORD ulP2) 
(static WORD iStyle; /* current selected style */ 


switch (iMsg) 
{case WM_INITDIALOG: 
switch (wibrObject.1bStyle) 

{case BS_HATCHED: 

iStyle=IDHATCH; break; 
case BS_SOLID: 

iStyle=IDSOLID; break; 
default: 

1Style=IDHOLLOW; break; 

} /* switch */ 
CheckRadioButton(hw, IDHOLLOW, IDSOLID, Style); 
return TRUE; /* no focus set */ 

case WM_PAINT: 
PaintDlgItem(hw, IOTHATCH); PaintDlgItem(hw, IDTSOLID); 
break; 

case WM COMMAND: 
switch (uPl) 

{case IOHOLLOW: 

case IDHATCH: 

case 10SOLID: 

if (P2HI==BN_CLICKED) 
{iStyle=uPl; CheckRadioButton(hw, IDHOLLOW, IDSOLID, iStyle); 
U u et 
break; 
case IDOK: 
/* store set value */ 
switch (iStyle) 
{case IDHOLLOW: 
wibrübject.1bStyle=BS_HOLLOW; break; 
case IDHATCH: 
wibrübject.1bStyle=8S_HATCHED; break; 
case 1D0SOLID: 
wIbrübject.1bStyle=BS_SOLID; break; 
} /* switch */ 

case IDCANCEL: 

/* close dialog box */ 
EndDialog(hw,uPl); return TRUE; 

} /* switch */ 
break; 

} /* switch */ 
return FALSE; 
} /* fdBrush() */ 


Phelshebebsieiohshheiebsleiekehsheächeinlalaiehelalshelokeelalshealchelnleheheheelakahslelaleiehalelaiahstekehelelchaietnhsielehehelhel 


ReadDdialog 
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This function creates a modeless dialog box, displayes it at screen 
and returns if the user closes the box. 

The function returns TRUE if the function DialogBox() returns IDOK and 
FALSE otherwise. If the dialog box is not created because the memory 
is too small, a message box with an error is created and FALSE is 
returned. 


Parameters: 
fd .. is the dialog box function. 
ußox is the number of the dialog box (DBX_...-key). 


Return: 

TRUE if the dialog box was created and the OK-button was pressed to 
close it or FALSE if the CANCEL-button was pressed or no box was 
created. 
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800L ReadDialog(WORD uBox,FARPROC rfd) 


(FARPROC rfdinst; 
int v; 


rfdinst=MakeProcinstance(rfd,hiMain); 
HpmSetDigBoxEnv(uBox); /* set identification of current box */ 
if (rfdinsti=NULL) 
{v=DialogBox (hiMain,MAKEINTRESOURCE (uBox) ‚hwMain,rfdinst); 
FreeProcinstance(rfdinst); 
if (vi=-1) 
{/* box was created: return TRUE if OK-button pressed */ 
return v==I1DOK; 
re it 
ri 
/* procedure-instance or box not created: print error message */ 
ErrorNoMem(hwMain); return FALSE; 
} /* ReadDialog() */ 
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CmdMain 
SessnmuusueEeunUNENREEISEUnSSEESSuS SEE SI Sun SE use eu ununuunennunnnn 
The command code <iCmd> of the main window is executed. Here only 
command codes from the system menu (CMD_...) are executed. Commands 
from child windows or similiar sources are not analysed here. 


Parameters: 

iCmd is the command code. 

Return: 

TRUE if the command was consumed, FALSE if not. 


erbeten nee] 


über Schlüsselwörter aufrufbar sind, aber mit 
insgesamt unzureichendem Zugriff. Es fehlt eine 
ausgereifte kontextorientierte Soforthilfe. Der 
Index mit den Schlüsselwörtern ist oft ziemlich 
klein und darüber hinaus merkwürdig hierarisch 
organisiert, so daß man sich über mehrere Ebe- 
nen an sein Problem herantasten muß. MS-Word 
oder PageMaker von Aldus sind Beispiele für sol- 
che Programme. Bei beiden kann der Hilfetext 
nicht parallel angezeigt werden, während man 
Befehle ausführt. So muß man einigen Hinwei- 
sen den Hilfetext (etwa beim Erstellen von 
Druckformatvorlagen) erst von Hand abschrei- 
ben oder ausdrukken, ehe man die empfohlene 
Anweisungsreihenfolge ausführen möchte, außer 
man rechnet sich zu den Anwendern, die pro- 
blemlos die Ausführungsreihenfolge zehn kom- 
plexer Anweisungen im Kopf behalten können. 

« Programme mit umfangreicher Soforthilfe, die 
sowohl über den Index- oder Verzeichniszugriff 
zu den Hilfetexten verfügen als auch über die 
Kontexthilfe. Sie kann sowohl vom Anfänger zum 
Erlernen bestimmter Fähigkeiten einer Applika- 
tion als auch vom Experten zum Nachschlagen 
selten benutzer Features der Applikation ein- 
gesetzt werden. Zu solchen Programmen zählen 
DOS-4-Shell, MS-Excel oder Quick-C (Version 
2.0). 

Abgesehen davon wurden etwa bei MS-Word 
oder Excel weitere Hilfefunktionen eingefügt, die 
unter Begriffen wie »Lernprogramm« oder 
»Leitfaden« dem Anwender dienen sollen. Solche 
Ergänzungen beruhen meist auf externen Pro- 
grammen, die unter dem betreffenden Programm 
aufgerufen werden. Um diesen Beitrag nicht zu 
lang werden zu lassen, wird auf die Realisierung 
dieser an sich sehr nützlichen Ergänzungen nicht 
weiter eingegangen. Im folgenden wollen wir 
uns detaillierter mit der Excel-Soforthilfe be- 
schäftigen, die im weiteren als Vorbild genom- 
men werden soll. 


Die Fähigkeiten 
der Excel-Soforthilfe 


Die Hilfe-Funktion von MS-Excel orientiert sich 
am Application-Style-Guide des Windows-SDK 
[1]. Die Taste Fl ist für den Hilfeaufruf reser- 
viert, er kann aber auch über das Hilfemenü am 
rechten Ende der Menüleiste erfolgen. Es gibt 
zwei Arten von Hilfen: Die indexorientierte Hilfe 
über den »Index«-Befehl im Menü und die kon- 
textorientierte Hilfe über die Tastenkombination 
Shift-F1 innerhalb eines Menüaufrufs oder 
Dialogfelds. Erstere beantwortet das »Wie«, die 
zweite das »Was« und »Warum«. Leider ist der 
Index hierarchisch aufgeteilt, so daß man Mühe 
hat, den Text zu einem bestimmten Problem zu 
finden. Es werden auch nicht alle Features von 
Excel in den Hilfetexten erläutert, so fehlen etwa 
Informationen über die Makrofunktionen. Man 
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kann also nicht ohne zusätzliches Excel-Refe- 
renzhandbuch arbeiten. 

Als weiteres ermöglicht die kontextorientierte 
Hilfe die Abfrage der Bedeutung von Menü- 
befehlen oder anderer Dialogelemente, bei- 
spielsweise am Fensterrand. Hierzu wird nach 
der Eingabe von Shift-F1 der Mauszeiger mit 
einem zusätzlichen Fragezeichen versehen. So- 
bald ein Menü oder ein anderes Dialogelement 
angeklickt wird, wird nicht die übliche Aktion 
ausgeführt, sondern statt dessen ein Hilfetext 
angezeigt, der die Aktion erklärt. Beim Aufruf 
von Befehlen im Menü erfolgt bei Excel automa- 
tisch eine Kurzbeschreibung des jeweils markier- 
ten Befehls in der Statuszeile, wie dies die SAA- 
Richtlinie vorschreibt. 

Die Hilfetaste F1 kann auch aktiviert werden, 
wenn ein Menüpunkt ausgewählt oder ein Dia- 
log- beziehungsweise Hinweisfeld angezeigt 
wird. In diesem Fall erläutert die Hilfeverwal- 
tung den markierten Menübefehl oder das ange- 
zeigte Dialogfeld. Bei Hinweisfeldern (etwa nach 
Eingabefehlern) wird der Fehler detaillierter er- 
läutert (Frage nach dem »warum«). Leider ent- 
hält Excel keine Hilfefunktion für die einzelnen 
Einträge innerhalb eines Dialogfelds. Man muß 
vielmehr langatmig den gesamten Text für ein 
Dialogfeld durchlesen, um Hinweise auf die ein- 
zelnen Dialogfelder zu erhalten. Bei größeren 
Dialogfeldern mit komplizierteren Auswahlmög- 
lichkeiten ist dies ziemlich »nervig«. Dies ist ein 
Schönheitsfehler, der noch beseitigt werden 
sollte. 

Andererseits entschädigt die Excel- 
Hilfeverwaltung mit interessanten Features bei 
der Anzeige des Hilfetextes. Diese erfolgt in 
einem eigenständigen Fenster, das ständig neben 
der Applikation gehalten werden kann und sich 
sogar zu einem Sinnbild verkleinern läßt. Die 
Größe des Fensters kann vom Anwender auf 
seine Bildschirmgröße angepaßt werden, das 
Format der Hilfetexte paßt sich entsprechend an 
(dynamischer Zeilenumbruch). Glossarbegriffe 
sind punktiert unterstrichen, mit einem Tasten- 
druck lassen sich die Definitionen solcher Be- 
griffe erhalten. Unterstrichene Querverweise, 
erlauben den schnellen Wechsel zwischen den 
einzelnen Hilfetexten, indem jene einfach mit der 
Maus angeklickt werden. 

Die Excel-Hilfe stellt sicherlich eines der am 
weitesten fortgeschrittenen Hilfeverwaltungs- 
Konzepte dar. Es ist unmöglich, in einer Imple- 
mentierung für einen Zeitschriftenartikel alle 
Eigenschaften zu übernehmen. Es wird daher vor 
allem Wert auf die Schnittstellen zu der Applika- 
tion und zum Windows-System gelegt, weiter- 
gehende Features wie Glossarbegriffe, Querver- 
weise, Fenster mit Textumbruch wurden dagegen 
nicht realisiert; sie stellen »Fleißarbeiten« inner- 
halb der eigentlichen Hilfeverwaltung dar, die 
den Rahmen dieses Artikels sprengen würden. 

Im folgenden Abschnitt wollen wir allmählich 


BOOL CmdMain(int iCmd) 


{switch(iCmd) 
{case CMD_ELLIPSE: 
j0bject=OBJ_ELLIPSE; break; 
case CMD SECTOR: 
i0bject=0BJ_SECTOR; break; 
case CMD_RHOMBUS: 
j0bject=0BJ_RHOMBUS; break; 
case CMD_SIZE: 
if (!ReadDialog(DBX_SIZE,fdSize)) return TRUE; 
break; 
case CMD_COLOR: 
if (!ReadDialog(DBX_COLOR,fdColor)) return TRUE; 
break; 
case (MD _BRUSH: 
if (IReadDialog(DBX_BRUSH,fdBrush)) return TRUE; 
break; 
case CMD_CLEAR: 
i0bject=0BJ_NONE; break; 
default: 
/* other commands: not consumed */ 
return FALSE; 
} /* switch */ 
/* redraw object */ 
InvalidateRect (hwMain,NULL,TRUE); return TRUE; 
} /* CmdMain() */ 
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Main Window function 
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LONG FAR PASCAL fwMain(HWND hw,WORD iMsg,WORD uP1,DWORD ulP2) 


{PAINTSTRUCT wps; 

HDC hdc; 

HPEN hpnOld; 

HBRUSH hbrOld,hbrFrame; 
POINT pCenter; 

int sxHalf,syHalf; 
RECT wre; 

LONG ulRet; 

HRGN hranE,hrgns; 
HEURSOR herSave; 


switch (iMsg) 

(case WM_CREATE: 
/* set application window handle */ 
hwMain=hw; return OL; 

case WM_SIZE: 
if (uPII=SIZEICONIC) HpmSetCmdLine(P2HI); 
break; 

case WM_PAINT: 
hdc=BeginPaint(hw,Awps); 
hpnOld=SelectObject (hdc,Createpen(0,1,wrgbObject)); 


hbrOld=SelectObject (hdc,CreateßrushIndirect (&wlbrübject)); 


GetClientRect (hw,äwrc); 
pCenter.xewrc.right/2; plenter.yswrc.bottom/2; 
sxHalf=(pCenter.x*sxObject)/100; 
syHal f= (pCenter.y*syObject)/100; 
switch (i0bject) 
{case OBJ_ELLIPSE: 
Ellipse 
(hdc,pCenter.x-sxHalf,pCenter.y-syHalf, 
pCenter.x+sxHalf,pClenter.y+syHalf 
); 
break; 
case OBJ_RHOMBUS: 
{POINT mpRhombus [4]; 


mpRhombus [0] .x=pCenter.x-sxHalf; mpRhombus[0] .y-plenter.y; 
mpRhombus [1] .x=pCenter.x; mpRhombus [1] .y=pCenter.y-syHalf; 
mpRhombus[2] .x=plenter.x+sxHalf; mpRhombus[2] .y=pCenter.y; 
mpRhombus [3] .x=pCenter.x; mpRhombus [3] .yrpCenter.y+syHalf; 
Polygon(hdc,mpRhombus,4); break; 
} /* case */ 
case OBJ_SECTOR: 

/* longer delay: set hour glass cursor */ 
herSave=SetCursor(LoadCursor (NULL, IDC_WAIT)); 

/* create region of elliptic part (very slow!) */ 
hronE=CreateElliptickgn 

(pCenter.x-sxHalf,pCenter.y-syHalf, 
pCenter.x+sxHal f,pCenter.y+3*syHalf 


/* create region of rectangle part */ 

hrgnS=CreateRectRgn 
(pCenter.x-sxHalf,pCenter.y-syHalf, 
pCenter.x+sxHalf,pCenter.y+syHalf 


/* combine both regions and draw cotents of regions */ 
CombineRgn (hrgnS,hron£,hrgnS,RGN_AND); PaintRgn(hdc,hrons); 
/* draw frame */ 
hbrFrame=CreateSol idBrush(wrgbübject); 
FrameRgn(hdc,hrons,hbrFrame,1,1); Deleteübject(hbrframe) ; 
SetCursor(herSave); /* set old cursor */ 
break; 

} /* switch */ 

/* select default painting objects, delete created objects */ 

DeleteObject (SelectObject (hdc,hpnOld)); 

Delete0bject (SelectObject (hdc,hbrO1d)); 

EndPaint(hw,äwps); return OL; 


case WM COMMAND: 
if (uPL!=CMD_EXIT) 
(/* user control command */ 
if (CmdMain(uP1)) 
{/* command executed, but help manager needs it too */ 
return HpmProcessHelpMsg(hw, iMsg,uPl,ulP2); 
I ZEIT 
break; /* not consumed */ 
rei 
/* continue */ 
case WM_CLOSE: 
DestroyWindom(hw); return OL; 
case WM _DESTROY: 
PostQuitMessage(0); return OL; 
} /* switch */ 
ulRet=HpmProcessHelpMsg(hw, iMsg,uP1,ulP2); 
if (ulRet!=0L) return ulRet; 
return DefWindowProc(hw,iMsg,uP1,ulP2); 
} /* fwMain() */ 
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Window dependent initialization (one for all instances) 


 / 
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CreateClass 


EBmSEnSSnsnsEenSSESEEESuES EEE EEE EEE En nn EEEEnEm Tannen nEmuS men eEn En Ten 
The classes of all application specific windows are registered. 


Parameters: 
none 


Return: 
TRUE if all classes created. 
FALSE if any error during creation (memory error). 


ee / 


800L Createllass(VOID) 
{WNDCLASS wwc; 


/* — Create window class of Application — */ 
wwc.IpszClassName=zAppName; wwc.hInstance=hiMain; 
wwc .IpfnkndProc=fwMain; 
wwc.hCursor=LoadCursor (NULL, IDC_ARRON) ; 
wwc.hbröackground=GetStockübject (WHITE_BRUSH) ; 
wwc.style=CS_HREDRAW|CS_VREDRAW; 

wwc.hIcon=NULL; 

wwc .IpszMenuName=MAKEINTRESOURCE (MNU_MAIN) ; 
wwc,cbClsextra=0; wwc.cbWndExtra=0; 

/* register window, return if error */ 

if (!RegisterClass(&mwc)) return FALSE; 

} /* Createllass() */ 
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Instance dependent initialization (for every instance) 


ee / 
Pan eher 


CreateAppWindow 


All globally existing windows are created by this function. 


Parameters: 
none 


Return: 
TRUE is returned if all data read, otherwise FALSE 
(memory too small). 


ee / 


BOOL CreateAppkindow(V010) 


{/* application's window, return if error */ 

if (I!CreateWindow 
(zAppName,rzAppTitle,WS_OVERLAPPEDWINDOW|WS_CLIPCHILDREN, 
CW_USEDEFAULT,O,CW_USEDEFAULT,O,NULL,NULL,hiMain, NULL) 
) 
return FALSE; 

return TRUE; 

} /* CreateAppWindow() */ 


] Aubnäshehuheiebobehahahalnhe ehaheluce hehe behabet ich ehahehaheabehehie kahahehahahe habuleheiehe bee eeeha hehe he haha 
InitIiInstance 

### The main init module entry point ### 

The complete initialization of a new instance of the application 

window. If no previous instance exists, the application window is 
initialized and the common data for all instances are created. 

Otherwise, common data are copied from the previous instance to the 
new instance. All individual data in the instance data segment are 
initialized. If memory is too small, a error message box is displayed 
and FALSE is returned. 


zur Implementierung der Hilfeverwaltung gelan- 
gen, indem wir die Anwenderseite verlassen und 
mehr die Probleme untersuchen, die den Pro- 
grammierer im Zusammenhang mit der Sofort- 
hilfe betreffen. 


Probleme beim Entwickeln 
einer Applikation 


Man fragt sich, warum die Soforthilfe bei vielen 
Applikationen eigentlich so stiefmütterlich im- 
plementiert wird. Der Grund liegt darin, daß der 
Entwickler eines Programms die Soforthilfe selbst 
nicht benötigt, da er natürlich »sein« Programm 
auswendig bedienen kann. Für viele Entwickler 
ist daher der Einbau einer Soforthilfe oder die 
Zusammenstellung der Hilfetexte eine lästige 
Aufgabe, die sie weitgehend ausklammern möch- 
ten. Erst bei entsprechendem Marktdruck, wenn 
die Forderungen der Kundschaft nach einer 
Hilfefunktion lauter werden, wird dann oft spon- 
tan und ohne große Überlegungen eine mehr 
oder weniger schlechte Soforthilfe integriert. Die 
Hilfetexte sind unzusammenhängend oder un- 
vollständig, der Index enthält nicht die Hinweise, 
die der Anwender letztendlich sucht. Gute Soft- 
ware-Entwickler sind nicht zwingend auch gute 
Lehrmeister für ihr Produkt, weil sie dieses zu 
sehr aus ihrer Implementierersicht betrachten 
und sich nicht ausreichend in den zunächst unbe- 
darften und naiven Benutzer hineinversetzen 
können. 

Größere Software-Häuser haben diesen Wider- 
spruch frühzeitig erkannt und beispielsweise das 
Schreiben der Handbücher von der Entwicklung 
der Software personell getrennt. Entsprechend 
sollte auch die Strukturierung der Soforthilfe und 
die Gestaltung ihrer Texte auf ergonomisch sen- 
sible Mitarbeiter übertragen werden, die weder 
programmieren können müssen, noch mit der 
internen Realisierung eines Produkts vertraut 
sein müssen (oder sollten). Für diese Trennung 
der Programmierung einer Applikation einerseits 
und der Gestaltung der Soforthilfe andererseits 
ist eine klare Schnittstelle vorzusehen, die mög- 
lichst einfach sein soll. Die Vorteile sind klar: Der 
Implementierer kann sich auf »seinen Code« 
konzentrieren und muß nur an wenigen Stellen 
auf die Soforthilfe Rücksicht nehmen, indem er 
Funktionen der Schnittstelle aufruft. Andererseits 
kann der Gestalter der Soforthilfe durch Kenntnis 
der Oberfläche und der Eigenschaften einer Ap- 
plikation unabhängig von der Implementierung 
durch den Programmierer seine ergonomischen 
Ideen (sogar parallel dazu) realisieren. 

Die Anzeige der Hilfetexte, ihre Auswahl und 
die Einbindung in eine Applikation sollte also 
applikationsunabhängig implementiert sein. Man 
wird daher den erforderlichen Code zur Steue- 
rung und Verwaltung der Hilfetexte in ein eigen- 
ständiges Modul legen, auf das der applikations- 
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spezifische Code zugreift und das mit den appli- 
kationsspezifischen Hilfetexten parametrisiert 
wird. Es ergibt sich somit eine Struktur gemäß 
Bild 1. Die Weiterentwicklung der Soforthilfe 
wird applikationsübergreifend und läßt sich pro- 
blemlos auf alle mit ihr realisierten Applikatio- 
nen übertragen. 


im— | 
l I 
| Hilfe-Texte/Struktur |< ——>|| Applikations-Code || 


be I 
U 1 
a = 


Schnittstelle ——— | 


I l 
1 Modul der Hilfe-Verwaltung I 
| (Organisation, Anzeige, Benutzerkommunikation) || 
1 l 


Das entwickelte Hilfe-Modul 


Das entwickelte Hilfemodul ist eine applikati- 
onsunabhängige Implementierung zur Verwal- 
tung von Hilfetexten, die die Fragen des Benut- 
zers nach dem »Wie«, »Was« und »Warum« einer 
Applikation beantworten sollen. Auch die Kurz- 
beschreibung von Menübefehlen innerhalb der 
Statuszeile beim Markieren dieser im Menü ge- 
mäß dem IBM-SAA-Standard ist durch das Hilfe- 
Modul automatisch integriert. 

Die Hilfetexte werden unabhängig vom Appli- 
kationscode zusammengestellt und verknüpft. 
Sie können über einen einfachen Index mit 
Schlüsselwörtern sowie innerhalb von Menüs, 
Dialog- und Hinweisfeldern mit F1 abgerufen 
werden. Nicht implementiert wurde das Anklik- 
ken von Dialogobjekten mittels des Mauszeigers 
mit Fragezeichen, wie sie Excel kennt. Es hätte 
den Rahmen des Artikels gesprengt, ist aber auch 
nicht so kompliziert, wie es zunächst aussieht. 
Vielleicht wird in einem späteren Beitrag einmal 
darauf eingegangen. 

Die bei Excel vermißte Zuordnung von Hilfe- 
texten zu einzelnen Elementen eines Dialogfelds 
wurde dagegen implementiert. Man setzt hierzu 
den Eingabefokus auf das gewünschte Element 
und betätigt Fl. Im Hilfefenster erscheint der 
zum dem Eingabeelement passende Hilfetext. 

Der Implementierer der Soforthilfe muß zum 
Zuordnen der Hilfetexte zu Befehlen, Hinweisen 
etc. der Applikation zwar die Funktionsweise der 
Applikation genau kennen (beispielsweise aus 
dem Pflichtenheft), über die Implementierung 
braucht er dagegen nur verhältnismäßig wenig 
Einzelheiten zu kennen, beispielsweise wie Be- 
fehle sowie Dialogelemente und -felder intern 
benannt sind. Im wesentlichen beschränkt sich 
dies auf Informationen, die in der Ressourcen- 
Datei angegeben sind, insbesondere der Aufbau 
der Menüs und der Dialogfelder (dialog boxes). 
Da es außer dem Programmcode und der Res- 


Parameters: 

hiNew is the handle to the new instance of window. 

hiPrev is the handle to the first instance of window (or NULL). 
rz(mdLine points to the command line buffer. 

vCmdShow is the entry style of window for Showkindow(). 


Return: 
TRUE is returned if initialization complete, 
otherwise FALSE (memory too small). 


ee / 


B00L InitInstance 
(HANDLE hiNew,HANDLE hiPrev,LPSTR rzCmdLine,int vCmdShow) 


{BYTE z[80]; 
WORD sz; 


hiMain=hiNew; /* set instance global */ 
Ye load the two strings for the no-memory error message 
sz=LoadString(hiMain,STAPPTITLE,z,sizeof(z)); 
rzAppTitle=(BYTE*)LocalAlloc(LMEM FIXED,sz+1); 
if (!rzAppTitie) return FALSE; 
strepy(rzAppTitle,z); 
sz=LoadString(hiMain,STNOMEM, z,sizeof(z)); 
rzNoMemory=(BYTE*)LocalAlloc(LMEM FIXED,sz+1); 
if (IrzNoMemory) return FALSE; 
strcpy(rzNoMemory,z); 
/* initialize first/further instance 
if (!hiPrev) 
{/* first instance: create window class, exit if error */ 
if (!CreateClass()) goto MemError; 
Y PAR 
/* create global application window */ 
if (!CreateAppWindow()) goto MemError; 
/* load accelerator table */ 
hAccel=LoadAccelerators(hiMain,MAKEINTRESOURCE (ACC_MAIN)); 
if (hAccel==NULL) return FALSE; 
/* initialize help manager */ 
Hpminit(hwMain,hiMain); 
/* show created main window */ 
Showdindow(hwMain,vCmdShow) ; UpdateWindow(hwMain); 
return TRUE; 
MemError: 
/* error: memory too small */ 
ErrorNoMem(NULL); 
return FALSE; /* return with error */ 
} /* InitInstance() */ 
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Main function 
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WORD PASCAL WinMain 
(HANDLE hiNew,HANDLE hiPrev,LPSTR rzCmdLine,int vCmdShow) 


IMSG wm; 


/* Initialize (window and) instance, return if error */ 
if (!InitInstance(hiNew,hiPrev,rzCmdLine, vCmdShow)) 
return 255; 
/* — application execution Ioop — */ 
while (GetMessage(&m,NULL,0,0)) 
{if (!HpmCheckMessage (&mm)) 
{/* message for application */ 
if (ITranslateAccelerator(hwMain,hAccel ‚Awm)) 
{TranslateMessage(Awn); DispatchMessage (Am) ; 
EEE 
iR u 
} /* while #/ 
return wn.wParam; 
} /* WinMain() */ 
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End of WINDOWS Application SHAPE 
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CC=CL >$*.ERR - -AS -65w -0d -W2 -Zip $*.C 


SHAPE.RES: SHAPE.RC DEFS.H HELP.TXT 
SPLIT # create *.HTX files from HELP.TXT 
RC -r $* 

DEL *.HTX 


HELPMGR.OBJ: HELPMGR.C HELPMGR.H 
$(cc) 


SHAPE.OBJ: SHAPE.C DEFS.H HELPMGR.H 
$(cc) 


SHAPE.EXE: HELPMGR.OBJ SHAPE.OBJ SHAPE.RES SHAPE.DEF 
LINK HELPMGR+SHAPE/A:16,SHAPE/CODEVIEW, „SLIBW+SLIBCEW/NOD,$*; 
RC $*.RES 
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SHAPE MS-Windows Application 
Resource file 
ERuEmSUNE ES En Enn EEE En N nEnEREEmSS ESS ESS EnE SS ESS ESeunSSSEuSmun SuSE 
Copyright 1989 by 
Marcellus Buchheit, Buchheit software research 
Zaehringerstrasse 47, D-7500 Karlsruhe 1 
Phone (0) 721/37 67 76 (West Germany) 
All rights reserved — Release 1.00 of 89-Jul-13 


ee / 


#include <STYLE.H> 
#include <HELPMGR.H> 
#include "DEFS.H" 


STRINGTABLE BEGIN 
STAPPTITLE,"SHAPE-Programm mit Hilfe” 
STNOMEM, "Zu wenig Speicher!\012Bitte beenden Sie eine Applikation.” 
STE_NUMVAL,"Illegaler numerischer Wert." 

END /* STRINGTABLE */ 


a | 
application's menu specification 


* 
1 
MNU_MAIN MENU BEGIN 
POPUP "&Zeichnen" BEGIN 
MENUITEM "&EITipse\t”E"CMD_ELLIPSE 
MENUITEM "&Raute\t”R" ,CMD_RHOMBUS 
MENUITEM "&Sector\t”S",CMD SECTOR 
MENUITEM SEPARATOR 
MENUITEM "Ende" ‚CMD EXIT 
END 
POPUP "B0ptionen" BEGIN 
MENUITEM "&Gr+e..."CMD_SIZE 
MENUITEM "&Farbe...",CMD_COLOR 
MENUITEM "F&”] muster. ..",CMD_BRUSH 
END 
MENUITEM "AL+schen“ „CMD_CLEAR 
POPUP "\aßHilfe" HELP BEGIN 
NENUITEM "&Hilfe-Index...\tF1",CMD_HELP_INDEX 
MENUITEM "&Kontexthilfe\tUmsch+F1",CMD_HELP CONTEXT,GRAYED 
END 
END /* MNU_MAIN */ 


N ——— nn > 
accelerators specification 


"/ . 
/* note: the NOINVERT option must be set to avoid printing of 
the command description text during the use of an accelerator */ 
ACC_MAIN ACCELERATORS BEGIN 
"NE" „CMD_ ELLIPSE,ASCII,NOINVERT 
"AR" „CMD_RHOMBUS,ASCIT „NOINVERT 
"5" „CMD_SECTOR,ASCIT „NOINVERT 
VK_F1,CMD_HELP_INDEX,VIRTKEYNOINVERT 
VK_F1,CMD_HELP CONTEXT,VIRTKEY,SHIFT ,NOINVERT 
END /* ACC_MAIN */ 


/* command description string table description */ 

STRINGTABLE BEGIN 
HCS_SYSMERU, "Steuermen": Fensterdarstellung Indern" 
HCS_SYSREST, "Normale Fenstergr+Me wiederherstellen" 
HCS_SYSMOVE,"Fensterposition Indern* 
HCS_SYSSIZE,"Fenstergr+Me Indern" 
HCS_SYSMIN, "Fenster-Sinnbild anzeigen" 
HCS_SYSMAX, "Fenster maximal vergr+Mern" 
HCS_SYSCLOSE, "Fenster schliellen, SHAPE beenden" 
HCS_POPUP1,"Objekt mit gewählten Optionen zeichnen* 
HCS_ELLIPSE, "Ellipse mit gew£hlten Optionen zeichnen" 
HCS_RHOMBUS, "Raute mit gewihlten Optionen zeichnen" 
HCS_'SECTOR,"Halbkreis mit gewählten Optionen zeichnen" 
HCS EXIT, "SHAPE-Programm beenden" 
HCS_POPUP2,"Optionen zum Zeichnen angeben" 
HCS_SIZE,"Objektgr+®e angeben" 
HCS COLOR, "Objektfarbe angeben“ 
HCS_BRUSH,"Objekt-F"} muster angeben" 
HCS_CLEAR,"Gezeichnetes Objekt I+schen” 
HCS_POPHELP, "Hilfe aufrufen" 
HCS_HELP_INDEX,"Stichw+rter f"r Hilfe aufrufen" 
HCS_HELP_CONTEXT, "Kontext-Hilfe aufrufen" 

END /* STRINGTABLE */ 


U 


' 
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I ————— 
help resources 
“ 


/* General help entries. 

This list contains the order of the help text */ 
#define HTX_APPL 3100 /* must be the value of HTX_FIRST */ 
#define HTX_OBJECT 3101 
#define HTX_MNUDRAW 3102 
#define HTX_CMDELIP 3103 
#define HTX_CMORHOMB 3104 
#define HTX_CMOSECT 3105 
#define HTX_CMDEND 3106 
#define HTX_OPTION 3107 
#define HTX_MNUOPT 3108 
#define HTX_SIZE 3109 
#define HTX_CMDSIZE 3110 
#define HTX_COLOR 3111 
#define HTX_CMDCOLOR 3112 
#define HTX_FILL 3113 


sourcen-Datei keine weiteren Teile gibt, die in 
die Applikationsdateien übernommen werden 
können, wird auch die komplette Implementie- 
rung der Fehlertexte, der Beschreibung der 
Struktur und die Art der Anbindung an Befehle, 
Dialogelemente etc. in der Ressourcen-Datei er- 
folgen. Die Hilfetexte werden dabei in neuen 
Ressourcen-Typen abgelegt. Im nächsten Ab- 
schnitt wird darauf eingegangen. Im Gegensatz 
zu Excel und anderen Applikationen existieren 
also keine weiteren Dateien mit den Hilfetexten 
wie etwa EXCELHLP.HLP; der Anwender weiß, 
daß die Applikation nur aus einer Datei besteht, 
und der Implementierer braucht nicht auf 
externe Dateien zuzugreifen (mit dem ganzen 
Anhängsel an Fehlerbehandlungen). Die Hilfe- 
texte in Ressourcen zu legen, hat jedoch auch 
Vorteile für die Laufzeit. Dies wird im nächsten 
Abschnitt untersucht. 


Hilfetexte als Ressourcen 


Ressourcen sind allgemein die bei Windows vor- 
zuziehende Implementierung von Datenobjekten, 
die beim Aufruf der Applikation bereits vorhan- 
den sind und meist auch nicht geändert werden 
müssen. Sie können nicht nur die vordefinierten 
Typen (Zeichenketten, Sinnbilder, Dialogfelder 
etc.) umfassen, sondern auch beliebige Daten. 
Viele Programmierer legen jedoch solche Daten 
immer noch als statische Variablen in ihrem C- 
Programm an. Diese Variante kostet jedoch viel 
Speicherplatz, da dadurch das Datensegment 
DGROUP, auf welches das DS-Segmentregister 
des Prozessors zeigt, belegt wird. Dieses Daten- 
segment kann nicht ausgelagert und auch häufig 
nicht in den EMS-Speicher geschoben werden, so 
daß der Hauptspeicher, das am meisten von 
Windows benutzte Betriebsmittel, stark belastet 
wird und somit die Gesamtleistung des gesamten 
Systems abnimmt. Außerdem werden dieselben 
Daten für jede Instanz einer Applikation neu 
angelegt. Ressourcen verhalten sich dagegen 
exakt wie Programmcode. Bei entsprechender 
Kennzeichnung in der Ressourcen-Datei werden 
sie aus dem Speicher entfernt (discarded), sobald 
andere wichtiger benötigte Daten geladen wer- 
den und der Speicher zu klein wird. Mehrere In- 
stanzen einer Applikation teilen sich gemeinsame 
Ressourcen, sie werden also nur einmal geladen 
(dadurch ist bei der Veränderung von Ressour- 
cen-Daten größte Vorsicht geboten!) 

Einer der größeren Implementierungsfehler ist 
es, Ressourcen zu laden und deren Inhalt an- 
schließend in selbst angelegten Speicher zu 
kopieren, was einige Programmierer insbeson- 
dere bei Zeichenketten tun. Dadurch geht näm- 
lich der Vorteil der effizienten Speichernutzung 
von Ressourcen wieder verloren. Leider wurde 
sogar in der früheren »HELLO«-Applikation des 
Windows-Toolkit diese »Todsünde« vorgeführt. 


44 Listing 3: 
Die Ressourcen-Datei 
SHAPE.RC 


Windows 


Microsoft 
System Journal 
Sept./Okt. 1989 


39 


P> Listing 3: 
Fortsetzung 


Windows 


Microsoft 
System Journal 


Sept./Okt. 1989 


40 


Wie bereits oben angedeutet, können Ressour- 
cen nicht nur Zeichenketten, Menüs, Sinnbilder, 
Dialogfelder etc. sein, sondern ein beliebiges, 
vom Programmierer entwickeltes Format besit- 
zen. Hierzu muß man der Ressource lediglich 
einen Typ zuweisen. Bei Windows können Res- 
sourcen numerische und namentliche Typen be- 
sitzen. Bei ersteren wird der Typ als eine Zahl 
zwischen 1 und 32767 angegeben, wobei die 
Standard-Ressourcen Werte zwischen 1 und 10 
besitzen und die weiteren Zahlen bis 255 für 
zukünftige Erweiterungen reserviert sind. Na- 
mentliche Typen bestehen aus einer Zeichenket- 
te, die mit O abgeschlossen ist. Der Nachteil von 
Namentypen ist, daß sie mehr Speicherplatz 
brauchen und langsamer sind. Außerdem kann 
man durch Analyse des .EXE-Codes leichter ein 
fremdes Programm analysieren, da die Namen 
natürlich die Bedeutung einer Ressource besser 
wiedergeben als eine Zahl. Wir verwenden daher 
für eigene Ressourcen-Typen ausschließlich Zah- 
len ab 256. 

Mit einem solchen Ressourcen-Typ können 
jetzt fast beliebig viele Ressourcen definiert wer- 
den, wieder entweder mit einer Zahl (zwischen 1 
und 32767) oder einem Namen. Aus obigen 
Gründen werden auch hier numerische Werte 
verwendet. Die Daten einer eigenen Ressource 
müssen in einer DOS-Datei stehen, Byte für Byte 
exakt wie sie in die EXE-Datei übertragen werden 
sollen und später vom Windows-Programm gele- 
sen werden. In der Ressourcendatei wird eine 
Ressource wie folgt definiert: 

Ressource-Nr Typ-Nr [Optionen] DOS-Dateiname 
Bei den Optionen sollte LOADONCALL, MOVE- 
ABLE und DISCARDABLE angegeben sein, sofern 
die Ressource nicht geändert und dauerhaft im 
Speicher stehen bleiben muß. Ressource-Num- 
mer und Typ-Nummer wird man natürlich zur 
besseren Lesbarkeit als Konstanten mit #define 
namentlich benennen. Diese selbstdefinierten 
Ressourcen eignen sich vor allem für Texte, da 
diese leicht mit einem Editor als Datei erstellt 
werden können. Bei Binärdateien ist für die Er- 
stellung dagegen häufig ein Generator erforder- 
lich, der auch erst geschrieben sein will. 

Wir verwenden für die Hilfetexte und deren 
Verwaltung insgesamt drei verschiedene Res- 
sourcen-Typen: Die Hilfetexte selbst sind als Res- 
source-Typ HELPTEXT (257) abgelegt und der 
Index ist vom Typ HELPLIST (256). Wichtig ist, 
daß in beiden Fällen die erstellten Textdateien 
mit dem EOF-Zeichen 26 (Strg-Z) abgeschlossen 
werden, sonst erkennt das Hilfe-Modul nicht das 
Ende der Texte. In der Index-Ressource steht in 
jeder Zeile ein Indexname. Die Namen müssen 
alphabetisch vorsortiert sein, so wie sie später im 
Index-Listenfeld erscheinen. 

Bei den Hilfetexten selbst wird die erste Zeile 
als eine Überschrift verwendet, die bei der An- 


zeige im Hilfefenster oberhalb des Hilfetextfelds 


erscheint. Die folgenden Zeilen enthalten den 


#define HTX_CMDFILL 3114 
#define HTX_CLEAR 3115 
#define HTX_CMDCLR 3116 
#define HTX_HELP 3117 
#define HTX_MNUHELP 3118 
#define HTX_CMOHPIX 3119 
#define HTX_CMDHPCTX 3120 


/* special help entries (dialog & message help texts) */ 
#define HTX_VERT 4000 
#define HTX_HORZ 4001 
#define HTX_SIZEOK 4002 
#define HTX_RED 4010 
#define HTX_GREEN 4011 
#define HTX_BLUE 4012 
#define HTX_COLOROK 4013 
#define HTX_FILLI 4020 
#define HTX_FILL2 4021 
#define HTX_FILL3 4022 
#define HTX_FILLOK 4023 
#define HTX_CANCEL 4100 
#define HTX_VERTVAL 4200 
#define HTX_HORZVAL 4201 


#define LMO LOADONCALL DISCARDABLE MOVEABLE /* load/memory options */ 


/* help index keyword list */ 
HLS_INDEX HELPLIST LMO INDEX.HTX 


/* index to help-text index table (alphabetical sorted) */ 
HLS_INDEX RCDATA LMO BEGIN 

HTX_CMDHPCTX, /* first entry is last available general help-text */ 
HTXLAPPL,HTX_COLOR,HTX_FILL,HTX_SIZE,HTX_HELP,HTX_CLEAR,HTX_OBJECT, 
HTX_OPTION 

END /* HLS_INDEX */ 


/* table of menu command help texts */ 
HLS_MENU RCDATA LMO BEGIN 


MNÜ_DRAN, HTX_MNUDRAW, 
CMD_ELLIPSE, _ HTXLCMDELIP, 
CMDRHOMBUS,  HTX_CMDRHONB, 
CMD_SECTOR, HTK_CMDSECT,, 
CMD_EXIT, HTXICMDEND, 
MNU_OPTION, HTXIMNUOPT 
CMD_SIZE, HTX_CMDSIZE, 
CMD_COLOR, HTX_CMDCOLOR, 
CMD_BRUSH, HTX_CMDFILL, 
CMD_CLEAR, HTX_CMDCLR, 
MNU_HELP, HTXÜMNUHELP, 


CMD HELP INDEX, HTX_CMOHPIX, 


CMD_ HELP CONTEXT,HTX_CMOHPCTX, + 


0 /* end of table */ 
END /* HLS_MENU */ 


/* table of dialog box items help texts */ 

HLS_DIALOG RCDATA LMO BEGIN 

DBX_SIZE, IDVERT,HTX_VERT, IOHORZ,HTX_HORZ,100K,HTX_SIZEOK,O 

D8X_COLOR, IDRED,HTX_RED, IDGREEN,HTX_GREEN, IDBLUE,HTX_BLUE, 
1DOK,HTX_COLOROK,O 

DBX_BRUSH, IDHOLLOW,.HTX_FILLI, TDHATCH,HTX_FILL2, IDSOLID,HTX_FILL3, 
100K,HTX_FILLOK,O 

0, IDCANCEL,HTX_CANCEL,O /* default dialog box */ 
END /* HLS_DIALOG */ 


/* table of message box help texts */ 

HLS_MESSAGE RCDATA LMO BEGIN 

STE_NUMVAL,DBX_SIZE, IDHORZ,HTX_HORZVAL, IDVERT ,HTX_VERTVAL,O 
0,0 /* end of default dialog box */ 

0 /* end of message string list */ 

END /* HLS_MESSAGE */ 


/* help text resources */ 

HTX_APPL HELPTEXT LMO APPL.HTX 
HTX_OBJECT HELPTEXT LMO OBJECT.HTX 
HTX_MNUDRAW HELPTEXT LMO MNUDRAW.HTX 
HTX_CMDELIP HELPTEXT LMO CMDELIP.HTX 
HTX_CMDRHOMB HELPTEXT LMO CMDRHOMB.HTX 
HTX_CMDSECT HELPTEXT LMO CMDSECT.HTX 
HTX_CMDEND HELPTEXT LMO CMDEND.HTX 
HTX_OPTION HELPTEXT LMO OPTION.HTX 
HTX_MNUOPT HELPTEXT LMO MNUOPT.HTX 
HTX_SIZE HELPTEXT LMO SIZE.HTX 
HTX_CMDSIZE HELPTEXT LMO CMDSIZE.HTX 
HTX_COLOR HELPTEXT LMO COLOR.HTX 
HTX_CMDCOLOR HELPTEXT LMO CMDCOLOR.HTX 
HTX_FILL HELPTEXT LMO FILL.HTX 
HTX_CMDFILL HELPTEXT LMO CMDFILL.HTX 


HTX_CLEAR HELPTEXT LMO CLEAR.HTX 
HTX_CMDCLR HELPTEXT LMO CMDELR.HTX 
HTX_HELP HELPTEXT LMO HELP.HTX 


HTXÜMNUHELP HELPTEXT LMO MNUHELP.HTX 
HTX_CMDHPIX HELPTEXT LMO CMDHPIX.HTX 
HTX_CMDHPCTX HELPTEXT LMO CMOHPCTX.HTX 


HTX_VERT HELPTEXT LMO VERT.HTX 
HTX_HORZ HELPTEXT LMO HORZ.HTX 
HTX_SIZEOK HELPTEXT LMO SIZEOK.HTX 
HTX_RED HELPTEXT LMO RED.HTX 
HTX_GREEN HELPTEXT LMO GREEN.HTX 
HTX_BLUE HELPTEXT LMO BLUE.HTX 


HTX_COLOROK HELPTEXT LMO COLOROK.HTX 
HTX_FILLI  HELPTEXT LMO FELLI.HTX 
HTX_FILL2 _HELPTEXT LMO FILL2.HTX 


HELPTEXT LMO FILL3.HTX 

HTX_FILLOK HELPTEXT LMO FILLOK.HTX 
HTX_CANCEL HELPTEXT LMO CANCEL.HTX 
HTX_VERTVAL HELPTEXT LMO VERTVAL.HTX 
HTX_HORZVAL HELPTEXT LMO HORZVAL.HTX 


I* 


HTX_FILL3 


dialog boxes specification 
* 
/ 


DBX_SIZE DIALOG LOADONCALL MOVEABLE DISCARDABLE 20,20,170,47 
CAPTION "Shape: Objektgr+Me* 
STYLE WS_BORDER|WS_CAPTION|WS_DLGFRAME |WS_POPUP 
BEGIN 
CONTROL "&Vertikal:" IDNONE,"static",SS_LEFT|WS_CHILD,28,8,36,8 
CONTROL "* „IDVERT,"edit",ES_LEFT|WS_BORDER|WS_GROUP|WS_TABSTOP| 
WS_CHILD,70,6,20,12 
CONTROL "%" IDNONE,"static*,SS_LEFT|WS_CHILD,94,8,4,8 
CONTROL "SHorizontal:",IDNONE,"static",SS_LEFT|WS_CHILD,20,30,44,8 
CONTROL ** IDHORZ, "edit",ES_LEFT|WS_BORDER|WS_GROUP|WS_TABSTOP| 
WS_CHILD,70,28,20,12 
CONTROL "x", IDNONE,"static",SS _LEFT|WS_CHILD,94,30,4,8 
CONTROL "Ok" „IDOK, "button" „BS_DEFPUSHBUTTON|WS_GROUP|WS_TABSTOP| 
WS_CHILD,114,6,50,14 
CONTROL "Abbrechen" IDCANCEL,"button", 
BS _PUSHBUTTON WS _GROUP|WS_TABSTOP|WS_CHILD, 114 R 14 
END /* DBX SIZE ii 
DBX_COLOR DIALOG LOADONCALL MOVEABLE DISCARDABLE 20,20,144, 66“ 
CAPTION "Shape: Objektfarbe" 
STYLE WS_BORDER|WS_CAPTION|WS_DLGFRAME |WS_POPUP 
BEGIN 
CONTROL "&rot:" „IDTRED,"static",SS_LEFT|WS_CHILD,8,8,16,8 
CONTROL "* „IDRED, "ScrollBar",SBS ;_HÖRZ |WS_ TABSTOP|WS_CHILD,30,8,32,8 
CONTROL "05%, IDVRED,"static",SS RIGHT |WS” CHILD,64,8,16,8 
CONTROL "&gr"n:" „IDTGREEN,"static",SS_LEFT|WS_CHILD,4,30,20,8 
CONTROL "* „IDGREEN, "ScrollBar",SBS ‚_HORZ|WS _TABSTOP|WS_CHILD, 
30,30,32,8 
CONTROL "0%" „IDVGREEN, "static",SS_RIGHT|WS_CHILD,64,30,16,8 
CONTROL "&blau:" „IDTBLUE,"static",SS_LEFT|WS_CHILD,4,52,20,8 
CONTROL "* „IDBLUE,"ScrollBar" „SBS_HORZ|WS_TABSTOP|WS_CHILD, 
30,52,32,8 
CONTROL "0%" „IDVBLUE,"static",SS_RIGHT|WS_CHILD,64,52,16,8 
CONTROL "Ok" IDOK,"button",BS_DEFPUSHBUTTON|WS_GROUP|WS_TABSTOP| 
WS_CHILD,88,28,50,14 
CONTROL "Abbrechen" IDCANCEL,"button", 
BS_PUSHBUTTON |WS_GROUP|WS_TABSTOP|WS_CHILD,88,48,50,14 
END /* DBX_ COLOR */ 
DBX_BRUSH DIALOG LOADONCALL MOVEABLE DISCARDABLE 20,20,148,70 
CAPTION "Shape: Fr} Imuster" 
STYLE WS_BORDER|WS_CAPTION|WS_DLGFRAME |WS_POPUP 
BEGIN 
CONTROL *" IDNONE, "static" ,SS_BLACKFRAME |WS_GROUP|WS_CHILD, 
32,14,34,12 
CONTROL "* „IDTHATCH, "static" .WS_BORDER|SS_USERITEM|WS_GROUP|WS_CHILD, 
32,32,34,12 
CONTROL **„IDTSOLID, "static" ,WS_BORDER|SS_USERITEM|WS_GROUP|WS_CHILD, 
32,50,34,12 
CONTROL "Muster" „IDNONE, "button" ‚BS_GROUPBOX|WS_GROUP|WS_CHILD, 
6,0,66,66 
CONTROL "&1* , IDHOLLOW, *button“ „BS_RADIOBUTTON | WS_GROUP|WS_TABSTOP| 
. WS_CHILD,10,14,14,12 
CONTROL "&2" ,IDHATCH, "button" ‚BS_RADIOBUTTON|WS_TABSTOP|WS_CHILD, 
10,32,14,12 
CONTROL "&3*,IDSOLID, "button" ,BS_RADIOBUTTON|WS_TABSTOP|WS_CHILD, 
10,50,14,12 
CONTROL "Ok", 1DOK, "button“ „BS_DEFPUSHBUTTON |WS_GROUP|WS_TABSTOP| 
WS_CHILD,92,30,50,14 
CONTROL "Abbrechen" „IDCANCEL, "button", 
BS_PUSHBUTTON| WS_GROUP|WS_ TABSTOP|WS CHILD,92,50,50,14 
END /* DBX_ BRUSH */ 
|? sueennnsnsnonneneennnnnneenne 
Resources of the help manager 
Sesenaeneennenmunnnumnannanzat/ 
DBX_HPMINDEX DIALOG LOADONCALL MOVEABLE DISCARDABLE 50,30,140,112 
CAPTION "SHAPE-Hilfe (Index)" 
STYLE WS_VISIBLE|WS_BORDER|WS_CAPTION]WS_DLGFRAME |WS_SYSMENU |WS_POPUP 
BEGIN 
CONTROL "Hilfe-Aindex* ,IONONE,"static",SS_LEFT|WS_GROUP|WS_CHILD, 
6,6,44 
CONTROL **,IDLIST,*listbox",LBS_NOTIFY|WS_VSCROLL|WS_BORDER |WS_GROUP| 
WS_TABSTOP|WS_CHILD,6,18,128,65 
CONTROL "Hilfe" 100K, "button" ,BS _DEFPUSHBUTTON|WS_GROUP|WS_TABSTOP| 
WS_CHILD,6,92,50,14 
CONTROL "Beenden" „IDCANCEL, "button" „BS_PUSHBUTTON|WS_TABSTOP| 
WS_CHILD,84,92,50,14 
END /* DBX_HPMINDEX rl, 


DBX_HPMTEXT DIALOG LOADONCALL MOVEABLE DISCARDABLE 50,30,226,122 

CAPTION "SHAPE-Hilfe" 

STYLE WS_VISTBLE|WS_BORDER|WS_CAPTION|WS_DLGFRAME|WS_SYSMENU|WS_POPUP 

BEGIN 

CONTROL *"IDTITLE,"static*,SS_LEFT|WS_CHILD,4,4,214,8 

CONTROL *" „IDTEXT,"edit",ES_MULTILINE|NS_BORDER|WS_GROUP|WS_CHILD, 
4,14,210,86 


CONTROL "" „IDTXSRL,*Scrol1Bar",SBS_VERT|WS_GROUP|WS_TABSTOP|WS_CHILD, 


214,14,8,86 
CONTROL "&lndex" „IOOK, "button", 
8S_DEFPUSHBUTTON|WS_GROUP|WS_TABSTOP|WS_CHTLD,4, 104,50, 14 
CONTROL "ABeenden" „IDCANCEL, "button", 
BS_PUSHBUTTON|WS_GROUP|WS_TABSTOP|WS_CHILD,60,104,50,14 
CONTROL "&Zur®ck*,TOPREV, "button", 
BS_PUSHBUTTON|WS_GROUP|WS_TABSTOP|WS_CHILD, 116,104,50,14 
CONTROL "Aleiter",IDNEXT, "button", 
8S_PUSHBUTTON|WS. GROUP |XS TABSTOP|WS_CHILD, 172,104,50,14 
END /* DBX_HPMTEXT */ 


Hilfetext, wobei eine neue Zeile mit Return ein- 
geleitet wird. Das Hilfemodul bewirkt einen 
automatischen wortweisen Zeilenumbruch, so 
daß die Formatierung nicht sehr kritisch ist. Im 
Beispiel ist die Breite des Hilfetextes auf 50 Zei- 
len beschränkt. Wichtig ist auch hier, bei der 
Eingabe nicht das EOF-Zeichen zu vergessen. 

Die Hilfetexte müssen mit dem Ressourcen- 
Compiler einzeln in die Applikationsdatei einge- 
baut werden, wofür sie auch als einzelne Dateien 
vorliegen müssen. Um nun zu verhindern, daß 
eine Vielzahl kleinster Textdateien angelegt und 
bearbeitet werden müssen, wird eine zusam- 
menhängende Hilfetext-Datei' mit Namen 
HELP.DAT verwendet, die alle Hilfetexte enthält. 
Für die Verarbeitung der Hilfetexte durch den 
Ressourcen-Compiler wird diese Datei automa- 
tisch von einem kleinen Hilfsprogramm mit 
Namen SPLIT zerlegt (siehe unten). Dieses Pro- 
gramm fügt auch die erforderlichen EOF-Zeichen 
am Ende dieser kleinen Dateien an. 

Da die Eingabe der Umlaute und Sonderzei- 
chen außerhalb von Windows nicht ganz einfach 
ist, ist es empfehlenswert, die Hilfetexte mit dem 
Notiz-Programm (oder bei größeren Text mit 
MS-Write) unter Windows zu erstellen. So kann 
man auch gleichzeitig die Applikation, für wel- 
ches die Hilfetexte geschrieben werden müssen, 
testen und inspizieren. 

Die Zuordnung von Hilfetexten zu Menü- 
befehlen, Dialogfeldern, Hinweiszeichenketten 
etc. erfolgt mittels Konstanten-Bezeichnern in 
festen Tabellen. Für die Realisierung dieser 
Tabellen bietet sich der vordefinierte Ressourcen- 
Typ »Row-Data« als dritter verwendeter Typ an. 
Er speichert angegebene Daten als 16-Bit-Werte 
nacheinander ab. Wie die Verwaltungstabellen 
damit genau aufgebaut werden, wird im näch- 
sten Abschnitt erklärt. 


Die Daten-Schnittstelle 
des Hilfemoduls 


Die applikationsspezifischen Angaben für die 
Hilfeverwaltung werden alle in der Ressourcen- 
Datei der Applikation untergebracht. Es ist sinn- 
voll, die folgenden Erläuterungen anhand der 
Ressourcen-Datei und der Definitionsdatei der 
Beispielapplikation in Listing 3 und 4 zu verfol- 
gen. Die applikationsspezifischen Erläuterungen 
dieser Listings erfolgen allerdings erst weiter 
unten. 

Die Zeichenketten für die Menü-Kurzbeschrei- 
bungen, die in der Statuszeile erscheinen, wer- 
den innerhalb einer STRINGTABLE vereinbart. 
Die Zeichenketten erhalten dabei Werte, die sich 
exakt um den Wert 2000 von den Befehlscodes 
der Menüeinträge unterscheiden. Der Übersicht 
halber sollten diese Zeichenketten-Werte mit 
»HCS_« beginnen. Die Befehlscodes werden in 
der Definitionsdatei wie üblich festgelegt. Eine 
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>> Listing 4: 
Die Konstanten- 
Definitionsdatei 
DEFS.H 


> Tabelle 1: 

Aufbau der Zeichen- 
kettentabelle für die 
Statuszeilen-Kurz- 
beschreibung. 


>> Listing 5: 
Die Linker- 
Definitionsdatei 
SHAPE.DEF 
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Aufschlagmenü-Überschrift (in der Menüleiste) 
besitzt aber keinen Befehlscode. Ihr wird deshalb 
als Pseudo-Code der Wert des ersten Befehls- 
codes des Menüs um eins erniedrigt zugewiesen. 
Somit kann auch diesem Eintrag eine Zeichen- 
kette zugewiesen werden. Leider kann der Res- 
sourcen-Editor bei #define-Angaben nicht mit 
Arithmetik umgehen. Angaben wie 

#define HCS_ELLIPSE CMD_ELLIPSE+2000 
werden mit »Syntax-Error« an der Einfügeposi- 
tion von HCS_ELLIPSE beantwortet. So muß 
man Konstanten für die Statuszeilen-Zeichenket- 
ten neu vereinbaren. Bei Veränderungen von 
Menüs hält sich der Aufwand in Grenzen, wenn 
die Befehlscodes in neuen Menüs mit gewissen 
Abständen beginnen, im Beispiel wurde hierfür 
die Zahl 20 gewählt. Da sich die Angaben auf die 
Befehlscodes der Menüs beziehen, sind problem- 
los dynamische Änderungen in den Menüs durch 
die Applikation möglich, sofern die Menübefehle 
eindeutige Befehlscodes erhalten. In der Zeichen- 
ketten-Tabelle sollten auch für die vordefinierten 
Menübefehle des Systemmenüs Beschreibungen 
angegeben werden. Der allgemeine Aufbau die- 
ser Ressource sollte den Angaben in Tabelle 1 
entsprechen. Die angegebenen Konstanten sind 
in der Kopfdatei der Hilfeverwaltung HELPMGR.H 
(Listing 6) vereinbart. 


STRINGTABLE BEGIN 

/* Beschreibung des Steuermenüs */ 
HCS_SYSMENU, Zeichenkette für Steuermenü 
HCS_SYSREST, Zeichenkette für Befehl »Wiederherstellen« 
HCS_SYSMOVE, Zeichenkette für Befehl »Bewegen« 
HCS_SYSSIZE, Zeichenkette für Befehl »Größe ändern« 
HCS_SYSMIN, Zeichenkette für Befehl »Sinnbild« 
HCS_SYSMAX, Zeichenkette für Befehl »Vollbild« 
HCS_SYSCLOSE, Zeichenkette für Befehl »Schließen« 

/* Beschreibung des 1. Aufklappmenüs */ 
Code des 1.Menübefehls+1999, Beschreibung des Menüs 
Code des 1.Menübefehls+2000, Beschreibung des Befehls 


Code des letzten Menübefehls+2000, Beschreibung des Befehls 
/* Beschreibung des 2. Aufklappmenüs */ 
Code des 1.Menübefehls+1999, Beschreibung des Menüs 


/* Beschreibung des Hilfe-Menüs */ 
HCS_POPHELP, Zeichenkette für Hilfe-Menü 
HCS_HELP_INDEX, Zeichenkette für »Hilfe-Index« 
HCS_HELP_CONTEXT, Zeichenkette für »Kontexthilfe« 
END /* STRINGTABLE */ 


Hilfetexte werden mit Nummern versehen. 
Allgemein sollten diese als Konstanten mit 
#define vereinbart werden und mit »HTX_« 
beginnen. Ihre Werte müssen mit dem Wert der 
Konstante HTX_FIRST (3000) beginnen und 
zunächst fortlaufend sein. Diese zusammenhän- 
genden Texte geben in ihrer Reihenfolge die 
Liste der allgemeinen Hilfetexte an. Die Hilfever- 
waltung erkennt sie als eine Einheit. Üblicher- 
weise verweisen die Einträge des Hilfe-Indexes 
auf diese Liste. Werte ab der Konstante HTX_ 
SPECIAL (4000) bezeichnen dagegen spezielle 
Hilfetexte, die nicht in der allgemeinen Textliste 
vertreten sind. Sie werden beispielsweise bei der 
Beschreibung von Dialogelement-Einträgen ange- 
sprochen. In der Ressourcen-Datei müssen die 


/* menu commands + popup-entries */ 
#define MNU_DRAW 120 
#define CMD_ELLIPSE 121 
#define CMD_RHOMBUS 122 
#define CMD_SECTOR 123 
#define CMD_EXIT 124 
#define MNU_OPTION 140 
#define CMD SIZE 141 
#define CMD COLOR 142 
#define CMD_BRUSH 143 
#define CMD_CLEAR 160 


/* dialog boxes */ 

#define DBX_SIZE 500 
#define DBX_COLOR 501 
#define DBX_BRUSH 502 


/* main menu */ 
#define MNU_MAIN 900 


/* accelerator */ 
#define ACC_MAIN 900 


/* strings */ 
#define STAPPTITLE 1000 
#define STNOMEM 1001 


/* error strings */ 
#define STE_NUMVAL 1500 


/* command description strings */ 
#define HCS_POPUPI 2120 
#define HCS_ELLIPSE 2121 
#define HCS_RHOMBUS 2122 
#define HCS_SECTOR 2123 


#define HCS_EXIT 2124 
#define HCS_POPUP2 2140 
#define HCS_SIZE 2141 


#define HCS_COLOR 2142 
#define HCS_BRUSH 2143 
#define HCS_CLEAR 2160 


/* dialog box entries */ 
#define IDNONE () 
#define IDHORZ 4000 
#define IOVERT 4001 
#define IDRED 4010 
#define IDGREEN 4011 
#define IDBLUE 4012 
#define IDTRED 4013 
#define IDTGREEN 4014 
#define IDTBLUE 4015 
#define IDVRED 4016 
#define IDVGREEN 4017 
#define IDVBLUE 4018 
#define IDHOLLOW 4020 
#define IDOHATCH 4021 
#define IDSOLID 4022 
#define IDTHATCH 4023 
#define IDTSOLID 4024 


NAME SHAPE 

REALMODE 

EXETYPE WINDOWS 

DESCRIPTION ‘Shape program with help manager" 
STUB 'WINSTUB,EXE' 

CODE MOVABLE DISCARDABLE SHARED 

DATA MOVABLE MULTIPLE 

HEAPSIZE 4096 

STACKSIZE 4096 


EXPORTS 

fwMain @1 

fdSize @2 

fdColor @3 

fdBrush @4 

; help manager functions 
fdHelpIndex 85 
fdHelpText ®6 
fwSubEdit @7 
fhMsgFilter @8 


Werte für alle Hilfetexte von Hand angegeben 
werden. Leider erlaubt der Ressourcen-Compiler 
keine flexiblere Beschreibung der Werte. 

Es folgen fünf Ressourcen, die alle Verwal- 
tungsdaten für die Soforthilfe beinhalten. Die 
erste ist vom selbstdefinierten Ressource-Typ 
HELPLIST und besitzt den Namen HLS_INDEX. 
Sie enthält alphabetisch sortiert die Schlüssel- 
wörter des Hilfe-Indexes. Sie werden in der Datei 


/* private resource types */ 
#define HELPLIST 256 
#define HELPTEXT 257 


/* commands for help menu */ 
#define MNU_HELP 280 
#define CMD_HELP_INDEX 281 
#define CMD_HELP_CONTEXT 282 


/* constants for sys-menu description */ 
#define HCS_SYSMENU 2100 


#define HCS_SYSREST 2101 
#define HCS_SYSMOVE 2102 
#define HCS_SYSSIZE 2103 
#define HCS_SYSMIN 2104 
#define HLS_SYSMAX 2105 


#define HCS_SYSCLOSE 2106 
#define HCS_POPHELP 2280 
#define HCS_HELP_ INDEX 2281 
#define HCS_HELP_CONTEXT 2282 


j 


/* entry functions of the help manager */ 

BOOL HpmInit(HWND hwAppl ‚HWND hiApp1); 

800L HpmCheckMessage(LPMSG rwm) ; 

LONG HpmProcessHelpMsg(HWND hw,WORD iMsg,WORD uP1,DWORD ulP2); 
VOID HpmSetCmdLine(WORD syClient); 

VOID HpmSetMsgBoxEnv(WORD iltem,WORD iString); 

vOID HpmSetDigBoxEnv(WORD iDIgBox); 


/* constants for help dialog boxes */ 
#define DBX_HPMINDEX 3000 
#define DBX_HPMTEXT 3001 


/* Vist of help index names */ 
#define HLS_INDEX 3030 
#define HLS_MENU 3031 

#define HLS_DIALOG 3032 
#define HLS_MESSAGE 3033 


/" help text areas 

HTX_FIRST..HTX_SPECIAL-1 is sorted by chapters, enter by index */ 
#define HTX_FIRST 3100 
#define HTX_SPECIAL 4000 


/* constants for help dialog items (can be used by applicaion too) */ 
#define IDLIST 3200 
#define IDTEXT 3201 
#define IDOTITLE 3202 
#define IDINDEX 3203 
#define IDPREV 3204 
#define IDNEXT 3205 
#define IDTXSRL 3206 


INDEX.HTX angegeben und vom Compiler als 
Ressource geladen. Anschließend folgt die Zu- 
ordnungstabelle des Hilfe-Indexes. Sie ist vom 
Typ »Row Data«, besitzt den Namen HLS_INDEX 
und enthält zunächst den Wert des letzten Hilfe- 
textes in der allgemeinen Textliste. Er muß ange- 
geben werden, damit die Hilfeverwaltung weiß, 
wann die Liste zu Ende ist. Im folgenden wird für 
jeden der alphabetisch sortierten Einträge in der 
Liste angegeben, welcher Hilfetext referenziert 
werden soll, wenn der Benutzer den Index-Ein- 
trag auswählt. Im Beispiel heißt der erste Eintrag 
»Applikation«, entsprechend wird der Hilfetext 
mit dem Index HTX_APPL angesprochen, der in 
der Datei APPL.HTX steht und die Applikation 
allgemein beschreibt. Tabelle 2 beschreibt das 
allgemeine Format der HLS_INDEX-Ressource. 


HLS_INDEX RCDATA LOADONCALL DISCARDABLE MOVEABLE 
Nummer des letzten Textes in der allgemeinen Hilfetextliste 
Textnummer für das erste Index-Schlüsselwort 
Textnummer für das zweite Index-Schlüsselwort 


Textnummer für das letzten Schlüsselwort im Index 
END /* HLS_INDEX */ 


Die nächsten Ressourcen dienen der Zuord- 
nung von Hilfetexten an Menübefehle, Dialog- 
Einträge und Hinweisfelder. Sie sind alle vom 
vordefinierten Typ »Row-Data«. Ihr Aufbau ist in 


Tabelle 3 bis Tabelle 5 allgemein beschrieben. Die 
Tabelle HLS_MENU wird verwendet, wenn inner- 
halb eines aufgeschlagenen Menüs F1 gedrückt 
wird. Sie sucht dann innerhalb dieser Tabelle 
den für den selektierten Befehl passenden Text. 
Auch hier gilt wieder für die Überschriften der 
Aufklapp-Menüs, daß sie einen Wert besitzen, 
der um 1 kleiner ist als der Befehlscode des 
ersten Menüeintrags (etwa MNU_OPTION = 
CMD SIZE - 1). Es brauchen nicht alle Befehle 
mit Hilfetexten versehen zu werden. Fehlt ein 
Befehl in der Tabelle, wird F1 ignoriert. 


HLS_MENU RCDATA LOADONCALL DISCARDABLE MOVEABLE 
/* Hilfetexte für das 1. Aufklappmenü */ 

Code des 1.Menübefehls-1, Textnummer für das Menüs 

Code des 1.Menübefehls, Textnummer für den 1.Befehl 


Code des letzten Menübefehls, Textnummer für den letzten Befehl 
/* Hilfetexte für das 2. Aufklappmenü */ 
Code des 1.Menübefehls-1, Textnummer für das Menü 


/* Hilfetexte für Beschreibung des Hilfe-Menüs */ 
MNU_HELP, Textnummer für Hilfe-Menü 
CMD_HELP_INDEX, Textnummer für »Hilfe-Index« 
CMD_HELP_CONTEXT, Textnummer für »Kontexthilfe« 
0 /* Ende der Tabelle */ 

END /* HLS_MENU */ 


HLS_DIALOG RCDATA LOADONCALL DISCARDABLE MOVEABLE 
/* Hilfetexte für Einträge des ersten Dialogfelds */ 
Dialogfeldnummer, 
Nummer 1.Eintrag, Textnummer, ..., Nummer letzter Eintrag, 
Textnummer 
0 /* Ende der Untertabelle für erstes Dialogfeld */ 
/* Hilfetexte für Einträge des zweiten Dialogfelds */ 
Dialogfeldnummer, 


1) 
/* Hilfetexte für Einträge in allen Dialogfeldern */ 
0 /* Erkennung daß letzte Untertabelle */ 
Nummer 1.Eintrag, Textnummer, ..., Nummer letzter Eintrag, 
Textnummer 
0 /* Ende der gesamten Tabelle */ 
END /* HLS_DIALOG */ 


HLS_MESSAGE RCDATA LOADONCALL DISCARDABLE MOVEABLE 

/* Hilfetexte für den ersten Hinweisfeld-Text */ 
Zeichenketten-Nummer des ersten Hinweisfeld-Texts 
Tabelle der Dialogfelder /* Aufbau wie Tabelle 4 */ 

/* Hilfetexte für zweiten Hinweisfeld-Text */ 
Zeichenketten-Nummer des zweiten Hinweisfeld-Texts 


/* Hilfetexte für den letzten Hinweisfeld-Text */ 
Zeichenketten-Nummer des letzten Hinweisfeld-Texts 
Tabelle der Dialogfelder /* Aufbau wie Tabelle 4 */ 
0 /* Ende der Tabelle */ 

END /* HLS_MESSAGE */ 


Die Ressource HLS_DIALOG ordnet den Ein- 
trägen in einem Dialogfeld Hilfetexte zu. Als 
Kennzeichen werden die Identifikationen der 
Dialogfelder (Anfang »ID«) genommen. Da je- 
doch häufig in unterschiedlichen Dialogfeldern 
Einträge mit gleichen Identifikationen verwendet 
werden (Begründung siehe weiter unten), wird 
zur eindeutigen Zuordnung auch die Identifika- 
tion des Dialogfelds angegeben. Die Ressource ist 
damit zweidimensional gegliedert, wie aus 
Tabelle 4 hervorgeht: Für jedes Dialogfeld wer- 
den die feldspezifischen Einträge und der zuge- 


44 Listing 6: 
Die Kopfdatei 
HELPMGAR.H der 
Hilfeverwaltung. 


«Tabelle 3: 
Aufbau der Tabelle 
HLS_MENU für die 
Verwaltung der 
Menü-Hilfetexte. 


“Tabelle 4: 

Aufbau der Tabelle 
HLS_DIALOG für die 
Verwaltung der Dia- 
logfeld-Hilfetexte. 


«Tabelle 5: 
Aufbau der Tabelle 
HLS_MESSAGE für 
die Verwaltung der 
Hinweisfelder-Hilfe- 
texte. 


44 Tabelle 2: 
Aufbau der Tabelle 
HLS_INDEX für die 
Verwaltung des 
Hilfe-Indexes. 
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> Tabelle 6: 

Die Eintrittsfunk- 
tionen der Hilfever- 
waltung. 
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Hpminit(HWND hwAppl, HWND hiAppl) 

HpmCheckMessage(LPMSG rwm) 

HpmProcessHelpMsg(HWND hw, WORD iMsg, WORD uP1, 
DWORD ulP2) 

HpmSetCmdLine(WORD syClient) 

HpmSetMsgBoxEnv(WORD iltem, WORD iString) 

HpmSetDigBoxEnv(WORD iDIgBox) 


ordnete Hilfetext angegeben. Abschließend kann 
in einem »allgemeinen« Dialogfeld (Angabe 0) 
ein Eintrag auf einen allgemeinen Hilfetext wei- 
sen, der sich nicht auf ein konkretes Dialogfeld 
bezieht und als Ersatzwert verwendet wird, wenn 
von der Hilfeverwaltung der Eintrag nicht in den 
vorangegangen dialogfeldspezifischen Unter- 
listen gefunden wurde. Im Beispiel etwa wurde 
das Feld »OK« (IDOK) feldspezifisch angegeben, 
das Feld »Abbrechen« (IDCANCEL) dagegen all- 
gemein. Die Hilfetexte unterscheiden sich vom 
Inhalt auch entsprechend. Alle Hilfetexte eines 
Dialogfelds werden von der Hilfeverwaltung zu 
einer Textliste zusammengefaßt, in der vor- und 
zurückgeblättert werden kann. Die Textwert- 
Angaben müssen daher sortiert und fortlaufend 
sein, außer in der Ersatzwert-Untertabelle. 

Die letzte Tabelle HLS_MESSAGE beschreibt 
die Hilfetext-Zuordnung für Hinweisfelder. Hier- 
bei wird zunächst von der Identifikation der Zei- 
chenkette ausgegangen, die in dem Hinweisfeld 
angezeigt wurde. Um einen Bezug zur Ursache 
des Hinweises herzuleiten, enthält jede Zeichen- 
ketten-Angabe in dieser Tabelle eine Liste von 
Dialogfeldern und deren Einträgen, die im Auf- 
bau exakt der HLS_DIALOG-Ressource ent- 
spricht. Die Ressource ist damit dreidimensional 
organisiert wie Tabelle 5 zeigt. Es brauchen aber 
nur die Einträge angegeben zu werden, von 
denen aus der Hinweis erfolgen kann. Damit 
bleibt die Tabellengröße meistens überschaubar. 

Abschließend erfolgt in einer längeren Tabelle 
die eigentliche Definition der Hilfetexte als Res- 
sourcen. Sie werden über ihren Textwert 
(Anfang »HTX_«) angesprochen. Die Hilfetexte 
selbst stehen in den anschließend angegebenen 
Dateien mit Endung ».HTX«. Hätte der Resour- 
cen-Compiler die gleichen Makrofähigkeiten wie 
»C«, würde sich die Gestaltung der Tabelle ver- 
einfachen. Nach der Angabe der Hilfetexte ist die 
Implementierung der Soforthilfe schon abge- 
schlossen. Im weiteren Verlauf der Ressourcen- 
Datei müssen noch die Dialogfelder für die Hilfe- 
verwaltung angegeben werden. Dies ist jedoch 
weitgehend applikationsunabhängig. Lediglich in 
den Überschriften der Dialogfelder sollten die 
Namen der Applikationen angegeben werden. 


Die Code-Schnittstelle 
des Hilfemoduls 


Tabelle 6 beinhaltet alle Funktionen, über die von 
einer Applikation aus auf das Hilfemodul zuge- 
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griffen wird. Die erste Funktion HpmInit initiali- 
siert die Hilfe-Verwaltung, legt das Fenster für 
die Statuszeile an und erzeugt alle weiteren 
erforderlichen Daten. Sie sollte während der 
Initialisierung der Applikation aufgerufen wer- 
den, aber erst nachdem das Applikationsfenster 
angelegt worden ist. Als Parameter werden die 
Bezüge (handles) auf die Applikationsinstanz und 
Applikationsfenster übergeben. 

Die Funktion HpmCheckMessage überprüft alle 
Nachrichten, die an die Applikation geschickt 
werden. Ihr muß nach jedem Aufruf von GetMes- 
sage in der Nachrichtenschleife der Applikation 
die empfangene Nachricht übergeben werden. 
Kehrt die Funktion mit einem Wert ungleich O 
zurück, war die Nachricht für die Hilfeverwal- 
tung bestimmt und darf nicht mehr weiter an 
TranslateMessage etc. übergeben werden. 

Auch innerhalb der Applikations-Hauptfenster- 
funktion müssen einer Modulfunktion alle Nach- 
richten übergeben werden, die das Hilfemodul 
gegebenenfalls auswertet. Diese Funktion heißt 
HpmProcessHelpMsg und sollte kurz vor dem Auf- 
ruf der Standard-Fensterfunktion DefWindowProc 
für alle Nachrichten aufgerufen werden, die von 
der Applikation nicht explizit verarbeitet wurden. 
Die Funktion liefert TRUE zurück, wenn sie die 
Nachricht so weit verarbeitet hat, daß diese nicht 
mehr an DefWindowProc übergeben werden darf. 
Andernfalls ist die Nachricht an letztere Funktion 
wie üblich weiterzuleiten. 


Die Anordnung der beiden letzten Funktionen 
innerhalb der Applikation erinnert an die MDI- 
Verwaltung von Kevin Welch [2]. Auch hier 
haben im wesentlichen zwei Funktionen die ent- 
scheidenden Nachrichten abgefangen und damit 
den größten Teil der Modulkommunikation 
übernommen. Tatsächlich lassen sich in der Pra- 
xis durch Kaskadierung mehrerer Nachrichten- 
Abfangfunktionen in der geeigneten Reihenfolge 
nach GetMessage in der Nachrichtenschleife und 
am Ende der Applikations-Fensterfunktion ele- 
gant Module in Applikationen einbinden. Die 
Methode zeigt erneut die Leistungsfähigkeit des 
Nachrichtenkonzepts von MS-Windows. 

Drei weitere Funktionen übergeben geänderte 
Daten an das Modul. Man könnte diese Daten 
effizienter über gemeinsame Variablen über- 
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Füllnuster 
Mit SHAPE können die Objekte mit unterschiedlichen 
Mustern gefüllr werden. Hierzu ist im Menü 

»Optionen« der Befehl »Füllmuster« zu wählen. 


geben, aber die ausschließliche Verwendung von 
Funktionen zur Datenübergabe an Module hat 
den Vorteil, daß man das Modul leicht zu einer 
dynamischen Link-Library (DLL) umwandeln 
kann, ohne daß die das Modul aufrufenden 
Applikationen geändert werden müssen. 

HpmSetCmdLine legt die Y-Position innerhalb 
des Applikationsfensters fest, an der das Unter- 
fenster der Statuszeile vom Hilfemodul positio- 
niert werden soll. Diese Funktion muß aufgeru- 
fen werden, wenn das Applikationsfenster in der 
Größe verändert wird. 

Die beiden Funktionen HpmSetMsgBoxEnv und 
HpmSetD1gBoxEnv übergeben aktuelle Werte für 
die Zuordnung von Fehlertexten an den augen- 
blicklichen Kontext, falls die Taste F1 innerhalb 
von Dialog- oder Hinweisfeldern aufgerufen 
wird. Die erste Funktion wird aufgerufen, bevor 
ein Text in einem Hinweisfeld ausgegeben wird. 
Als Argumente wird der Wert des zugrundelie- 
genden Dialogfeld-Eintrags und der Wert der 
Zeichenkette aus der Ressourcen-Datei angege- 
ben. Die Funktion HpmSetDlgBoxEnv übergibt 
ähnlich die Nummer der aktuell verwendeten 
Dialogfeld-Definition aus der Ressourcen-Datei. 
Aus allen drei Werten ist eine eindeutige Zuord- 
nung auf den gegenwärtigen Kontext möglich. 

Die Aufrufe der Hilfeverwaltung können leicht 
an zentralen Stellen angebracht werden. Sie be- 
lasten daher den Implementierer der eigentlichen 
Applikation kaum. Die Hauptarbeit für die Imple- 
mentierung der Soforthilfe liegt in der Ressour- 
cen-Datei, also außerhalb des oft komplizierten 
Programmcodes. Da die Hilfe-Daten in der Res- 
sourcendatei darüberhinaus stark objektorien- 
tiert sind, ist es zumindest denkbar, diese Daten 
interaktiv und automatisch zu erzeugen. 


SHAPE: Eine kleine 
Anwendung des Hilfe-Moduls 


Als Beispiel, wie die Hilfeverwaltung in eine 
Applikation integriert werden kann, wurde ein 
kleines Programm zum Zeichnen von einfachen 
geometrischen Objekten gewählt. Es war mein 
erstes selbständig entwickeltes und implemen- 
tiertes Programm für MS-Windows. Ich hatte 
mich vor längerer Zeit ein wenig in die Beispiele 


des Windows-Toolkit eingearbeitet und wollte 
nun eigene Ideen in einer Applikation realisieren, 
um erste Erfahrungen zu sammeln. Die Ideen 
waren etwas ausgefallen, es gab außer dem 
Windows-Toolkit keinerlei Literatur und ich war 
so unbedarft an die Sache herangegangen, daß 
ich fast drei Monate benötigte, bis die Applika- 
tion endlich fertig war. Erfahrungen hatte ich 
dabei allerdings reichlich gesammelt. Das Pro- 
gramm heißt SHAPE und kann wahlweise eine 
Ellipse, eine Raute oder einen halben Ellipsen- 
sektor mit wählbarer Farbe und auswählbarem 
Füllmuster zeichnen, siehe hierzu Bild 2. Die 
Größe des Objekts wird in vertikalen und hori- 
zontalen Teilen der Applikationsfenstergröße 
angegeben. Der Hilfe-Index in Bild 3 mit den 
Schlüsselwörtern wird über das Hilfe-Menü oder 
die Taste F1 aufgerufen. Nachdem ein Begriff 
ausgewählt worden ist, kann mit Doppel-Klick, 
der Eingabetaste oder der Schaltfläche »Hilfe« 
der dazugehörige Text in einem neuen Dialogfeld 
gelesen werden (Bild 4). Der Begriff zeigt dabei 
in den allgemeinen Teil der Hilfetexte, in dem 
mit den Schaltflächen »Weiter« und »Zurück« vor 
und zurück geblättert werden kann. Mit »Index« 
kann wieder zur Schlüsselwörter-Liste zurückge- 
kehrt werden, »Beenden« schließt die Soforthilfe, 
ebenso wie die Eingabe von Esc oder ein doppel- 
tes Anklicken des Steuermenüs des Dialogfelds. 
Die Hilfedarstellung kann angezeigt bleiben, 
wenn andere Befehle aufgerufen werden. Ein 
Wechsel zwischen Hilfe-Dialogfeld und Appli- 
kation ist mit Alt-F6 möglich. 

Die Einstellung der Varianten beim Zeichnen 
der geometrischen Gebilde erfolgt über drei 
Dialogfelder im Menü »Optionen«. Bild 5 zeigt 
das Dialogfeld zur Einstellung der Farben. Jeder 
RGB-Farbanteil wird prozentual mit einer Rollei- 
ste eingestellt und als Prozentwert rechts dane- 
ben angezeigt. Die Überschriften links von der 
Rolleiste sind in den betreffenden Farben ange- 
zeigt, sofern dies der Bildschirm ermöglicht. Die 
Auswahl des gewünschten Füllmusters erfolgt 
mit einem weiteren Dialogfeld. Wie man aus Bild 
6 ersehen kann, werden die Objekte mit dem 
Füllmuster und mit der eingestellten Farbe im 
Dialogfeld dargestellt. Weitere Informationen 
über die Bedienung von SHAPE können aus den 
Hilfetexten entnommen werden. 


44 Bild 3: 
Der Index der Hilfe- 
Verwaltung. 


“Bild 4: 
Ein angezeigter 
Hilfetext. 
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» Bild 5: 
Einstellung der Far- 
ben. 


>> Bild 6: 

Auswahl des Füll- 
musters mit Anzeige 
der Muster. 
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Außer über den Index können Hilfetexte auch 
aus dem aktuellen Kontext aufgerufen werden, 
indem die Taste F1 betätigt wird. Dies ist bei- 
spielsweise aus einem Aufschlagmenü heraus 
möglich, wenn mit der Tastatur der gewünschte 
Eintrag markiert, aber nicht aufgerufen wird. 
Gibt man jetzt Fl ein, erscheint der Hilfetext zum 
Menü-Befehl (Bild 7). Auch innerhalb von Dia- 
logfeldern können (im Gegensatz zu MS-Excel) 
Hilfetexte zu einzelnen Dialogeinträgen abgeru- 
fen werden. Hierzu ist die Eingabemarkierung 
(der Fokus) auf den gewünschten Eintrag zu set- 
zen. Anschließend ist wieder Fl einzugeben und 
der entsprechende Text erscheint, siehe Bild 8. 
Ähnlich verhält es sich bei der Hilfeanfrage nach 
Fehlermeldungen. Wird etwa bei der Einstellung 
der Objektgröße eine ungültige Zahl oder ein 
Wert über 100 eingegeben, erscheint zunächst 
die Fehlermeldung »Illegaler numerischer Wert«. 
Wird, statt den Hinweis mit »Ok« zu bestätigen, 
F1 eingegeben, erscheint ein Hilfetext mit der 
Erläuterung des Fehlers, wobei auch die Bedeu- 
tung des Eingabefelds berücksichtigt wird, die 
zum Fehler beitrug. 

Ein Fehler im Windows-System erlaubt leider 
nicht die Benutzung der Hilfe-Dialogfenster wäh- 
rend andere modale Dialogfenster angezeigt 
sind. Die Mausbenutzung funktioniert aber wei- 
terhin. Die Ursache dieses Problems wird weiter 
unten beschrieben. 


Implementierung von SHAPE 


Obwohl SHAPE ziemlich simpel erscheint, zeigt es 
doch einige recht nützliche Windows-Program- 
miertechniken. In Listing 1 ist der C-Quelltext der 
Applikation abgedruckt. Er greift auf das Modul 
der Hilfeverwaltung zu, der weiter unten in die- 
sem Artikel erläutert wird. Die MAKE-Datei zum 
Übersetzen der Quelldateien zeigt Listing 2. Da 
der Ressourcen-Compiler die einzelnen Hilfetexte 
benötigt, wird die Datei HELP.DAT durch den Auf- 
ruf des DOS-Programms SPLIT in einzelne Be- 
standteile zerlegt. Nach dem Durchlauf des Res- 
sourcen-Compilers werden dann diese Hilfs- 
dateien, die alle mit .HTX enden, wieder gelöscht. 
Der Ressourcen-Compiler übersetzt die Ressour- 


cen-Datei SHAPE.RC in Listing 3. Gemeinsame 
Definitionen in Ressourcen-Datei und C-Quell- 
datei sind in DEFS.H in Listing 4 enthalten. Die 
Module werden mit LINK, Version 5, zu der 
Applikation zusammengesetzt. Die hierzu erfor- 
derliche Linker-Definitionsdatei ist in Listing 5 
abgedruckt. Wichtig ist, hierin nicht die Fenster- 
und Dialogfunktionen der Hilfeverwaltung zu 
vergessen. Die Verbindung zu dem Modul der 
Hilfeverwaltung wird über dessen Kopfdatei 
HELPMGR.H (Listing 6) erreicht. Die Quellcode der 
Hilfeverwaltung befindet sich in Listing 7 als 
HELPMGR.C. Wir werden weiter unter noch näher 
darauf eingehen. Alle Hilfetexte sind in der Datei 
HELP.TXT zusammengefaßt, siehe hierzu Listing 
8. Jeder einzelne Text beginnt mit einer Zeile, 
die mit dem Prozentzeichen eingeleitet ist, ge- 
folgt von beliebig weiteren und abschließend 
dem Namen der .HTX-Zwischendatei. Hierbei 
muß es sich um den Dateinamen handeln, der 
entsprechend in der Ressourcen-Datei angegeben 
ist. Weitere Sonderzeichen existieren in der ein- 
fachen Implementierung der Hilfeverwaltung 
nicht. Listing 9 zeigt schließlich noch den Quell- 
text des DOS-Programms SPLIT.C. Neben der 
Separierung der Datei HELP.TXT fügt es auch die 
erforderlichen EOF-Zeichen an die Enden der 
.HTX-Zwischendateien an. Das Programm enthält 
sonst keine Besonderheiten. Übersetzt wird es 
durch den Aufruf von »CL SPLIT.C« 


Die Ressourcen-Datei 
SHAPE.RC 


Die Ressourcendatei SHAPE.RC ist ziemlich um- 
fangreich, da sie außer der Hilfeverwaltung auch 
die Dialogfeld-Definitionen des Hilfemoduls um- 
faßt. In der STRINGTABLE am Anfang sind alle 
Zeichenketten aufgeführt, die die Applikation zur 
Ausgabe verwendet. Neben der Applikationsfen- 
ster-Überschrift sind dies die Fehlermeldungen. 
Am Ende der Menüberschreibung ist das Hilfe- 
menü angegeben. Durch Angabe der Option HELP 
und dem Zeichen »\a« erhält man das charak- 
teristische Erscheinungsbild dieses Eintrags. 
Nach der Definition der Abkürzungstasten folgen 
die Daten für die Hilfeverwaltung. Der Aufbau 
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Dieser Befehl ruft ein BESLPRE eld aus, mit dem 


bjektgröfle angeben 


dieser Ressourcen wurde bereits weiter oben be- 
schrieben. Es wird daher hier nicht mehr weiter 
darauf eingegangen. 

Im folgenden sind die Definitionen der appli- 
kationsspezifischen Dialogfelder angegeben. Sie 
sind weitgehend standardmäßig implementiert. 
Lediglich bei DBX_BRUSH fällt zweimal der Fen- 
sterstil SS_USERITEM auf. Was es damit auf sich 
hat, wird im nächsten Abschnitt erläutert. Am 
Schluß folgen die Dialogfenster für die Hilfetext- 
Anzeige. Man beachte, daß in DBX_HPMTEXT eine 
zusätzliche Rolleiste neben das Anzeigefeld ge- 
legt wurde, es ist die einzige Möglichkeit, einen 
rollbaren Text anzuzeigen, ohne daß man diesen 
verändern kann (siehe weiter unten). 


Die Realisierung von 
SHAPE.C 


Nun zu den Besonderheiten innerhalb von 
SHAPE.C. Bei SHAPE wurde zunächst versucht, 
prototypenhaft eine einigermaßen »professionel- 
le« Version einer Windows-Applikation zu schrei- 
ben. Neben der integrierten Hilfeverwaltung zäh- 
len hierzu: 

« Verlagerung aller nationaler Texte und Beson- 
derheiten in die Ressourcen-Datei. 

« Eine klare Fehlermeldung, wenn der Speicher 
zu klein ist. 

« Vorinitialisierungen von Dialogfeldern und 
klare Fokus-Positionierungen nach Fehleingaben. 
« Verwendung von flexiblen Funktionen für häu- 
fig benötigte Aufgaben wie etwa das Einlesen 
von Daten durch Dialogfelder. 

SHAPE eignet sich damit gut als Ausgangspunkt 
für die Entwicklung neuer Applikationen. Ich 
schaue mir sehr oft bestimmte Stellen von 
SHAPE an, um mir wieder ins Gedächnis zu 
rufen, wie ich ein bestimmtes Problem üblicher- 
weise implementiere. Das betrifft insbesondere 
die teilweise aufwendige Verwaltung von Daten 
innerhalb der Dialogfelder. Vereinfachungen er- 
geben sich etwa in der Art der Funktion ReadD1g- 
ItemInt: Sie liest nicht nur den Wert des gewün- 
schten Textfelds, sondern überprüft den ge- 
lesenen Wert, gibt gegebenenfalls eine Fehler- 
meldung aus und setzt den Eingabefokus auf das 
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fehlerhafte Feld. In den eigentlichen Dialogfeld- 
funktionen fdSize ist dann die korrekte und be- 
nutzerfreundliche Verarbeitung der numerischen 
Daten ziemlich einfach. Die Strategie, möglichst 
viel Datenverwaltung aus Dialogfunktionen in 
separate Funktionen zu verlagern, wird unter- 
stützt von der Möglichkeit, für die Einträge in 
den Dialogfeldern feste Konstanten zu wählen. 
Werden für ähnliche Einträge in unterschiedli- 
chen Dialogfeldern dieselben Konstanten ge- 
wählt, kann man ganze Gruppen von Dialogein- 
trägen durch dieselbe Funktion verarbeiten, als 
Parameter muß lediglich der Fensterbezug 
(window handle) des Dialogfelds angegeben wer- 
den. Bei mehreren gleichartigen Eintragsklassen 
lassen sich Schleifen für die Verarbeitung der 
Einträge verwenden. Dies wird in SHAPE anhand 
der drei Rolleisten für die Farbeinstellung in der 
Funktion fdColor gezeigt. Nebenbei wird durch 
unterschiedliche Interpretation der WM_CTL- 
COLOR-Nachricht erreicht, daß die Texte der 
Rolleisten in verschiedenen Farben angezeigt 
werden. Wie man sieht, ist es sehr einfach, durch 
Abfangen dieser Nachricht farbige Dialogele- 
mente zu erzeugen. Die Fensterfunktion enthält 
auch die komplette Verarbeitung der WM_H- 
SCROLL-Nachricht einer Rolleiste und ihre sofor- 
tige Umsetzung, hier in den entsprechenden Aus- 
gabewert. 

Als ich SHAPE implementierte, war es für mich 
ein größeres Problem, beliebige Bilder in Dialog- 
feldern zur Verbesserung der Darstellung anzu- 
zeigen. Sinnbilder lassen sich bekanntlich sehr 
leicht übernehmen, sind aber umständlich zu 
zeichnen und kennen keine flexiblen Größen. Ein 
Implementierungsvorschlag für beliebige recht- 
eckige grafische Elemente wird im Dialogfeld 
DBX_BRUSH für die Auswahl des gewünschten 
Füllmusters gezeigt: In der Ressourcen-Datei 
werden die betreffenden Elemente mit der Klasse 
»static«e und dem Stil SS_USERITEM definiert. 
Wenn nun das Windows-System das Dialogfeld 
zeichnet, übergibt es der Dialogfunktion, in die- 
sem Falle der Funktion fdBrush, die Nachricht 
WM_PAINT. Diese kann abgefangen werden, um 
die gewünschten Elemente selbst zu zeichnen. 
Dies wird der Übersicht halber in der Funktion 
PaintDIgItem durchgeführt: Zunächst wird die 
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Größe des betreffenden Elements ermittelt, der 
Zeichenkontext (device context) angefordert und 
der bisherige Inhalt des Elements mit Invali- 
dateRect ungültig gemacht. Das weitere Zeich- 
nen erfolgt wie sonst üblich: Das gewünschte 
Füllmuster wird erzeugt, dem Zeichenkontext 
zugewiesen und das ganze Fenster als Rechteck 
damit gefüllt. Abschließend werden die erzeug- 
ten GDI-Attribute wieder freigegeben. 

Die Funktion ReadDialog verwaltet das Umfeld 
beim Erzeugen eines modalen Dialogfelds. Sie 
liefert TRUE zurück, wenn zum Beenden des 
Dialogfelds »Ok« eingegeben worden war und 
FALSE, wenn »Abbrechen« gewählt wurde. Ist 
zuwenig Speicherplatz vorhanden, um das Dia- 
logfeld aufrufen zu können, wird statt dessen das 
Hinweisfeld darauf angezeigt. Diese Funktion 
ruft auch die Funktion HpmS$etDlgBoxEnv der 
Hilfe-Verwaltung auf. 

In der eigentlichen Fensterfunktion der Appli- 
kation mit Namen fwMain liegt der Schwerpunkt 
auf dem Zeichnen des ausgewählten geometri- 
schen Objekts mit den eingestellten Attributen. 
Am Anfang werden die eingstellten Zeichenattri- 
bute (Linienfarbe, Füllmuster) erzeugt. An- 
schließend wird das gewählte Objekt gezeichnet. 
Bei der Raute erfolgt dies mit der Windows- 
Funktion Polygon, die einen geschlossenen, füll- 
baren Kurvenzug erzeugt. Komplizierter gestaltet 
sich die Zeichnung des halben Ellipsensektors: 
Man erzeugt zunächst eine Windows-Region 
einer ganzen Ellipse und eine Region des halben 
Rechtecks. Anschließend bildet man den Durch- 
schnitt über beide Regionen. Die neue Region 
stellt aufgrund des erzeugten Durchschnitts eine 
halbe Ellipse dar, die anschließend mit PaintRgn 
mit dem eingestellten Muster ausgefüllt und 
deren Rand mit FrameRgn ausgezogen wird. Lei- 
der ist das Erzeugen von elliptischen Regionen 
außerordentlich langsam, es kann durchaus 
Minuten dauern, bis der Sektor gezeichnet ist! 
Aus diesem Grund wird auch der Mauszeiger 
durch die Sanduhr ersetzt. Nur verhältnismäßig 
kleine Regionen sind schnell gezeichnet. Es ist 
bedauerlich, daß ein solch leistungsfähiges Kon- 
zept wie die Regionen in der Praxis daher nur 
eingeschränkt verwendbar ist. 

Die restlichen Funktionen von SHAPE dienen 
der Initialisierung der Applikation. Sie sind weit- 
gehend Standard und werden nicht mehr weiter 
erläutert. Oben wurde erwähnt, daß Ressourcen- 
Daten niemals im Datenspeicher extra gehalten 
werden sollten. Eine Ausnahme davon wurde am 
Beginn der Funktion InitInstance gemacht: Die 
Zeichenketten, die für die Ausgabe der Fehler- 
meldung bei zuwenig Speicher benötigt werden, 
sollten sich ständig im Speicher befinden. Nur 
dadurch ist garantiert, daß sie ihren Zweck auch 
erfüllen. Denn bei zu wenig Speicher ist die 
Wahrscheinlichkeit groß, daß er auch für das 
Nachladen der Zeichenketten nicht mehr aus- 
reicht. Das Ergebnis wäre ein leeres Hinweisfeld! 
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HELPMGR Help-Manager for MS-Windows applications 


This module controls and organizes the help management for a 
MS-Windows application which has linked it. 


Copyright 1989 by 
Marcellus Buchheit, Buchheit software research 
Zaehringerstrasse 47, D-7500 Karlsruhe 1 
Phone (0) 721/37 67 76 (West Germany) 


Release 1.00 of 89-Jul-29 — All rights reserved. 


WERKE / 


#define NOMINMAX 
#include <WINDOWS.H> 
#include "HELPMGR.H" 


/* further C standard headers */ 
#include <STDLIB.H> 
#include <STRING.H> 


/* window function parameter macros */ 
#define P2LO LOWORD(uIP2) 

#define PZHI HIWORD(ulP2) 

#define LADDR(r) "(LONG) (LPSTR) (r) 


/* local module data values */ 
static WORD sxChar; /* width of a SYSTEM character */ 
static WORD syChar; /* height of a standard SYSTEM character */ 


static HWND hwMain; /* handle of application's main menu */ 
static HANDLE hiMain; /* handle of application's instance */ 


/* description line definitions */ 
#define S_CMD_DESCR 45 /* number of characters in description Tine */ 
static HWND hwLine; /* window handle of command description line */ 


/* current help mode */ 
enum {HPM_NONE,HPM_INDEX,HPM_CONTEXT} ; 
static int iHelpMode=HPM NONE; 


static HWND hwObxHelp; /* window handle for the help dialog boxes */ 
FARPROC rfdHelp; /* instance of help dialog box function */ 
FARPROC rfwSubEdit; /* subclassing function for "edit" class */ 
FARPROC rfwürgEdit; /* window function of original "edit" class */ 
static int iTextPos; /* text position in help text */ 

static int iTextlen; /* number of lines in help text */ 

static int iMenuCmd; /* last selected menu command */ 

/* current help text environment */ 

static int iCurkelpText; /* current set help-text, O0 if no text set */ 
static int iTextfirst; /* minimum general help-text index */ 

static int iTextlast; /* maximum general help-text index */ 

static HANDLE hindex; /* handle of index table resource */ 


/* current message/dialog box environment */ 

static int iCurDIgBox; /* ident of selected dialog box ident */ 
static int iCurDigltem; /* ident of selected dialog box item */ 
static int ilurMsgString; /* ident of message string */ 


/* pointers to message filter hook functions */ 
FARPROC rfhMsgFilter,rfhPrevMsgFilter; 


| Ash ge ck ie he chen ing he ieh dla he 
HpmSetCmdline 
PPEUFPFEEPEPPPELELDEEPEEDEEDEEDEESEEEEEESLDELELELULDEUPEREPEPOSPLPLLTTT 
This function sets and displayes the command description line after 
the application window was resized. 


Parameters: 

syClient is the new vertical size of the client area of 
the application window. 

Return: 


none 
|| 


VOID HpmSetCmdLine(WORD syClient) 


{SetWindowPos 
(hwLine,NULL,-1,syClient-(syChar+4-1) ‚0,0, 
SWP_NOACTIVATE|SWP_NOZORDER|SWP_NOSIZE 
); 

Showwindow(hwLine,SW_SHOWNA) ; 

} /* HpmSetCmdLine() */ 


EEE 


GetTextindex 
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This function determines the index number of the help text for the 
entry <i> in the help keyword index and returns it as a WORD. The 
first WORD in the list (at 0) contains the maximum available help text 
of the index. 


Parameters; 
hwBox is the handle of the dialog box window. 


Return: 
The index of the text is returned. It is 0 if it was not determined. 


WERKE EEE / 


static int GetTextIndex(WORD i) 


{WORD FAR *ru; 
int iVal; 


if (hIndex==NULL) return 0; /* memory full => not found */ 
/* get index of help text via resource table (type RCDATA) */ 
ru=(WORD FAR*)LockResource(hindex); 

iValeru[li]; UnlockResource(hindex); 

return iVal; 

} /* GetTextIndex() */ 


Jr 
GetIindexPos 

This function gets the entry in the index list for the text 
<iCurHelpfext> if this is not 0. The position of this or the previous 
position in the index is returned. Extremely the lowest index value is 
returned. 

Parameters: 

none 

Return: 

The position of the current help text is returned. If <iCurHelpfext> 
is 0 the first entry in the index is returned. 


a / 


static int GetIndexPos (VOID) 


{WORD FAR *rmuTable,FAR *ru; 
int iEntry,nEntry; 
WORD iFound=0; 


if (!hIndex||iCurHelpText==0) return 0; /* memory too small */ 
/* get index of help text via resource table (type RCDATA) */ 
rmuTable= (WORD FAR*)LockResource(hindex); nEntry=rmuTable[0]; 
/* search in index list */ 
for (iEntry=O,ru=rmuTable+l;iEntry<nEntry; iEntry++,rut+) 
{if (*ru<ssiCurHelpText && *ru>rmuTable[iFound+1]) 
(/* set new "previous" element */ 
iFound=iEntry; 
Year 
} /* for */ 
UnlockResource (hindex) ; 
return iFound; 
} /* GetindexPos() */ 


F Auichehuiuiukuiehehehuiehaiehebuhhaleiheishebehchehhsichsiahehsiehehuhstohnhchshahshakehshehahuhehohehehehehehshuinhnhahnhohehe hehnhuhel 
LoadHelpindex 

This function reads the help index word list from resource HLS_INDEX 
and sets it into the listbox IDLIST of dialog box <hwBox>. 

Parameters: 

hwBox is the handle of the dialog box window. 

Return: 

none 


ee / 


static VOID LoadHelpIndex(HWND hwBox) 


{HANDLE hindex; 
LPSTR rzText,rzEnd; 
BYTE c; 


hindex=FindResource 
(hiMain,MAKEINTRESOURCE(HLS_INDEX) „MAKEINTRESOURCE (HELPLIST)); 
if (hindex) hIndex=LoadResource(hiMain,hindex); 
if (!hIndex) return; /* memory too small */ 
rzText=LockResource(hIndex); 
while (*rzText!=26) 
{/* read next string until end of line */ 
rzEnd=rzText+1; 
while ((c=*rzEnd)1=0 48 ci='\r' 88 cl='\n' && cI=26) rzEnd++; 
*rzEnd=0; /* temporary end of string */ 
SendDigItemMessage (hwBox, IDLIST,LB_ADDSTRING,-1,LADDR(rzText)); 
while ((c=*rzEnd)<' ' && c!=26) rzEnd++; /* search next string */ 
rzText=rzEnd; /* new start of string */ 
} /* while */ 
UnlockResource(hIndex); /* resource can be moved/discarded */ 
) /* LoadHelpindex() */ 


/* needed forward references */ 

BOOL FAR PASCAL fdHelpindex(HWND hw,WORD iMsg,WORD uP1,DWORD ulP2); 
LONG FAR PASCAL fwSubEdit(HWND hw,WORD iMsg,WORD uP1,DWORD ulP2); 
BOOL FAR PASCAL fdHelpText(HWND hw,WORD iMsg,WORD uP1,DWORD ulP2); 
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SetindexHelp 


SESERELSSSSEEREUEESSSSSICDERTESSSSESHEREESTSSEHEEESERERSESERTEEETERESS 


This function creates the index help modeless dialog box and sets the 
new help mode. 


Parameters: 
none 

Return: 
none 
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Implementierung der 
Hilfeverwaltung 


In diesem und den folgenden Abschnitten soll 
noch kurz auf die Implementierung der Hilfe- 
Verwaltung eingegangen werden, wie Listing 7 
sie zeigt. Es sollen nur die für den Windows- 
Programmierer interessanten Eigenschaften er- 
läutert werden. 

Die Funktion HpmInit erzeugt alle erforder- 
lichen Daten der Hilfeverwaltung. Das Status- 
zeilen-Fenster wird als Tochterfenster des Appli- 
kationsfenster in der richtigen Größe angelegt. 
Da es nur Text anzeigen muß, wurde hierfür die 
vordefinierte Klasse »Static« gewählt. Als Stil 
wurde ihm ein Rahmen hinzugefügt. Weiterhin 
legt die Funktion den Systemeingriff zum Um- 
lenken benötigter Systemnachrichten (siehe 
unten) an. 

Eine der wichtigsten Funktionen stellt HpmPro- 
cessHelpMsg dar, die die für die Hilfeverwaltung 
interessanten Nachrichten auswertet. Aus der 
Nachricht WM _MENUSELECT, die sonst kaum inter- 
essiert, läßt sich die augenblickliche Position im 
Menü bestimmen, daraus die passende Zeichen- 
kette für die Statuszeilen-Kurzbeschreibung 
laden und jene über die Windows-Funktion Set- 
WindowText in der Statuszeile ausgeben. Als wei- 
tere Aufgabe der Funktion dient das Abfangen 
der Hilfe-Befehle CMD HELP INDEX und 
CMD_HELP_CONTEXT. Während die erstere den 
Hilfe-Index einschaltet, ist der letztere Befehl 
noch nicht realisiert. 

Die anderen Funktionen sind zwar teilweise 
recht komplex, bieten aber insgesamt wenig 
neues. Jeder, der mit »C« vertraut ist, müßte ihre 
Funktionsweise nachvollziehen können. Statt 
dessen gehen wir abschließend noch auf zwei 
Windows-spezifische Details des Hilfemoduls ein. 


Allgemeiner Zugriff 
auf Ressourcen 


Sicherlich interessiert Sie, wie man auf die Res- 
sourcen mit den selbstdefinierten Typen zu- 
greifen kann. Betrachten wir hierzu die Funktion 
LoadHelpIndex, die die Liste des Indexes in ein 
Listenfeld überträgt. Zunächst muß die Res- 
source in der Applikationsdatei gefunden wer- 
den. Dies erledigt die Windows-Funktion Find- 
Resource. Als Argument erhält sie den Namen 
der Ressource und den Typ (hier HELPLIST). Die 
Funktion liefert einen Bezug zurück, der von Null 
verschieden ist, falls die Ressource gefunden 
wurde. Zugegriffen wird auf die Ressource aller- 
dings erst mit der Windows-Funktion Load- 
Resource. Sie gibt einen Bezug zurück, der einem 
Bezug eines globalen Speicherobjekts sehr ähn- 
lich ist. Ähnlich wie bei diesen Objekte, kann 
man mit der Funktion LockResource die Adresse 
der Ressource erhalten. Erst nach Rückkehr von 
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dieser Funktion ist die Ressource wirklich in den 
Speicher geladen worden. UnlockResource gibt 
die Adresse wieder frei, und die Daten können 
beliebig verschoben oder aus dem Speicher vom 
System entfernt werden. LoadResource über- 
prüft auch, ob sich eine angeforderte Ressource 
bereits im Speicher befindet und gegebenfalls 
wird deren Bezug zurückgegeben. Wie man 
sieht, ist der Zugriff auf allgemeine Ressourcen 
nicht schwieriger als auf andere angelegte Spei- 
cherobjekte. Es lohnt sich also, Daten in Ressour- 
cen anzulegen. 


Anzeige der Hilfetexte 


Der Index der Hilfeverwaltung wird in einem 
Listenfeld gehalten, was problemlos ist. Doch wie 
zeigt man die Hilfetexte an? Eine Art Textanzei- 
gefeld existiert im Windows-System nicht und im 
»Edit«-Feld könnten die Texte unzulässigerweise 
geändert werden. Normalerweise müßte man 
hierfür eine neue Fensterklasse entwickeln, doch 
dann würde dieser Artikel zur Serie werden. 
Glücklicherweise gibt es die Unterklassen-Tech- 
nik [3], mit der sich zwar das Problem nicht per- 
fekt, aber doch ganz brauchbar lösen läßt: Im 
Dialogfeld DBX_HELPTEXT wird aus der »Edit«- 
Klasse des IDTEXT-Eintrags eine Unterklasse er- 
zeugt, die durch die Funktion fwSubEdit reali- 
siert wird. Diese macht nichts anderes, als zu 
verhindern, daß der Fokus dem Textfenster zuge- 
ordnet oder irgendein Zeichen diesem übergeben 
werden kann. Folglich kann der Text weder mar- 
kiert noch geändert werden. Zum Blättern im 
Hilfetext benötigt man allerdings eine Rolleiste. 
Die implizite Rolleiste der »Edit«-Klasse ist 
unbrauchbar, denn diese erhält ja keine Tastatur- 
eingaben mehr. Als Lösung wurde dem Textfeld 
eine zusätzliche Rolleiste danebengestellt, die 
nun das Blättern und Rollen im Textfeld genauso 
gut wie die Original-Rolleiste durchführt. Nur 
der Implementierungsaufwand steigt leicht an, 
da die Kommunikation zwischen beiden Elemen- 
ten realisiert werden muß. 


Systemeingriff in Menü- 
und Dialogfeldverwaltung 


Um bei der Anzeige von Menüs, Dialog- und 
Hinweisfeldern die Taste F1 abfangen zu kön- 
nen, wird wie in [2] ein Systemeingriff (im Ori- 
ginal system hook) verwendet, den die Funktion 
fhMsgFilter realisiert. Jedesmal, wenn den be- 
treffenden Windows-Elementen eine Nachricht 
gesandt wird, wird die Funktion aufgerufen und 
die Nachricht analysiert. Wurde die Taste F1 ge- 
drückt, wird der entsprechende Hilfetext ausge- 
hend vom aktuellen Kontext gesucht und gege- 
benfalls angezeigt. Anschließend wird die Funk- 
tion wieder verlassen und der ursprüngliche 


static VOID SetIndexHelp(VOID) 
{if (!hindex) 
{/* load index for the first time */ 
hIndex=FindResource 
(hiMain,MAKEINTRESOURCE (HLS_INDEX) „MAKEINTRESOURCE (RT_RCDATA)); 
if (hindex) hindex=LoadResource(hiMain,hindex) ; 
if (!hIndex) return; /* cannot load */ 
NAT 
/* create modeless dialog box */ 
rfdHelp=MakeProcInstance(fdHelpIndex,hiMain); 
if (CreateDialog 
(hiMain,MAKEINTRESOURCE(DBX_HPMINDEX) ‚hwMain,rfdhelp)) 
(/* help box created */ 
iHelpMode=HPM_INDEX; 
Mir ® 
} /* Setindexkelp() */ 
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SetContextHelp 

PEN EEEEEEEEEEEEEDSEDUDLELLLIUELLLELLELLERULEELOODE OLE EU er 
This function creates the context help modeless dialog box and sets 
the new help mode. 

Parameters: 

iNewfext is the index of the new help text. 

Return: 

none 

ra 


static VOID SetContextHelp(int iNewText) 


(iCurHelpText=iNewText; /* set new text */ 
rfdHelp=MakeProcinstance(fdHelpText,hiMain); /* dialog function */ 
if (CreateDialog 
(hiMain,MAKEINTRESOURCE (DBX_HPMTEXT) ‚hwMain,rfdHelp)) 

{/* help box created */ 

iHelpMode=HPM_CONTEXT; 

DICH 
} /* SetContextHelp() */ 


Fed ka ha aha ha behla ha a he aa hebt haha heat hekubalchelaicheiehsdshalsiuheiehsishshsisickukeisiehehılabsheiehel 
ResetHelp 

PL EELEEEELEEEDEOELULLLIULELLLLULLTe 
This function resets the help mode and destroyes the current help 
modeless dialog box. 

Parameters: 

none 

Return: 

none 

ee 


static VOID ResetHelp(VOID) 


{DestroyWindow(hwObxHelp); hwDbxHelp=NULL; iHelpMode=HPM NONE; 
FreeProcinstance(rfdHelp): 
} /* ResetHelp() */ 


Pre 


fdHelpiIndex 

### Dialog Box function ### 

This function processes any messages received by the "Help index" 
dialog box. 

Parameters: 

standard message data 

Return: . 

standard dialog box function value. 


a  / 


BOOL FAR PASCAL fdHelpindex(HWND hw,WORD iMsg,WORD uP1,DWORD ulP2) 


tint i; 
switch (iMsg) 
{case WM_INITDIALOG: 
hwDbxHelpshw; /* set global variable */ 
LoadHelpIndex(hw); /* load resource with help-index keywords */ 
/* select current set index entry */ 
SendDigItemlessage(hw, IDLIST,LB_SETCURSEL,GetindexPos(),OL); 
return TRUE; /* no focus set */ 
case WM COMMAND: 
switch (uPl) 
{case IDLIST: 
if (PZHII=LBN_DBLCLK) return OL; /* consumed */ 
/* double-click causes ID0K: continue */ 
case IDOK: 
/* get selected index */ 
i=(int)SendDIgItemMessage(hw, IDLIST,LB_GETCURSEL,0,0L); 
if (i==LB_ERR| |(i=GetTextIndex(i+1))==0) i=0; /* no text */ 
case IDCANCEL: 
/* close modeless index dialog box */ 
ResetHelp(); 
if (uP11=IDCANCEL 36 i!=0) 
{/* switch into context help */ 
iTextFirst=HTX_FIRST; 
iTextlast=GetTextindex(0); /* set range */ 
SetContextHelp(i); 
rare 
return TRUE; /* consumed */ 
} /* switch */ 
break; 
} /* switch */ 
return FALSE; 
} /* fdHelpIndex() */ 


ee 


LoadHelpText 
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This function reads the help text from resource with value <ihelpText> 
and sets it into the *edit* field IDTEXT of dialog box <hwBox>. The 
extra scroll bar for the "edit* field is initialized and set to first 
line. The previous and next buttons are disabled if no genera] help 
text is available in the corresponding direction. 

Parameters: 

hwBox .... is the handle of the dialog box window. 

iHelpText is the resource nımber of the help text. 

Return: 

TRUE if the text is loaded, FALSE if not 


Write / 


static BOOL LoadHelpText (HWND hwBox,int iHelpText) 


{HANDLE hindex; 
LPSTR rzText,rzEnd; 
BYTE c; 


hindex=FindResource 

(hiMain,MAKEINTRESOURCE (iHelpText) „MAKEINTRESOURCE(HELPTEXT)); 

if (hindex) hindex=LoadResource (hiMain,hindex); 

if (!hindex) return FALSE; /* text not loaded */ 
rzText=LockResource(hindex); 

/* first line is title */ 

rzEnd=rzText; while ((c=*rzEnd)1=0 885 ci='\r’ 84 cl='\n’) rzEnd++; 
*rzEnd=0; /* temporary end of title */ 

SetDIgItemText (hwBox,IDTITLE,rzText); 

while ((c=*rzEnd)<' ' 88 c1=26) rzEnd++; /* search start of text */ 
/* search end of help text */ 

rzText=rzEnd; while ((c=*rzEnd)!=0 && c!=26) rzEnd++; 

*rzEnd=0; /* temporary end of text */ 
SetDigItemText (hwBox, IDTEXT,rzText); 

UnlockResource(hindex); /* resource can be moved/discarded */ 

/* initialize scroll bar */ 
iTextLen=(int)SendDlgItemMessage (hwBox, IOTEXT,EM GETLINECOUNT,O,OL); 
iTextLen=max(iTextLen-10+1,1); iTextPos=1; 
SetScrollRange(GetDigItem(hwBox,IDTXSRL),SB_CTL,1,iTextLen, FALSE); 
SetScrol Pos (GetDIgItem(hwBox,IDTXSRL),SB_CTL,iTextPos, TRUE); 
return TRUE; /* text is loaded */ 
} /* LoadhelpText() */ 
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fwSubEdit 

#4# Subclassing window function ### 

This function avoids any text change in a window of the "Edit" class. 
The text can only be scrolled by using the EM_LINESCROLL message. 
Parameters: 

standard message data 


Return: 
standard window function return value. 
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LONG FAR PASCAL fwSubEdit(HWND hw,WORD iMsg,WORD uP1,DWORD ulP2) 
{LONG vRetValue; 


vRetValue=0L; 
switch (iMsg) 
{case WM_SETFOCUS: 
case WM_KEYDOWN: 
case WM CHAR: 
/* ignore input focus/character input: caret cannot be set */ 
return OL; 
} /* switch */ 
/* call original window function */ 
return CallWindowProc(rfwürgEdit,hw, iMsg,uPl,ulP2); 
} /* fwSubEdit() */ 


PAubslebsieicbshstelehslelsbalebskslsichslskslalsteiahselakslshkelekhelskslslsiukelakkaluksstakelakkelsteheduknlsksheleleiskaleiehnhed 
fdhelpText 
EITPPTTPPPEREEERELLLEELUELEEELELEOOERSPPOPTETELELDELDELTELLELEPEPELDER 
### Dialog Box function #43 

This function processes any messages received by the DBX_SIZE dialog 
box. 


Parameters: 
standard message data. 


Return: 


standard dialog box function value. 
TER ae / 


BOOL FAR PASCAL fdHelpText(HWND hw,WORD iMsg,WORD uP1,DWORD ulP2) 
fint 1; 


switch (iMsg) 
(case WM_INITDIALOG: 
hwDbxHelpshw; /* set global variable */ 
/* subwindowing of IDTEXT "edit" window: no changes possible */ 
rfwOrgEdit=(FARPROC) SetWindowLong 
(GetDIgItem(hw, I0TEXT) „GWL_WNDPROC, (LONG) rfwSubEdit); 
/* load resource with specified help text */ 
LoadHelpText(hw, iCurHelpText); 
return TRUE; /* no focus set */ 


Datenweg des Windows-Systems fortgesetzt. Der 
Systemeingriff WH_MSGFILTER ist übrigens 
einer der wichtigsten und der einzige, der pro- 
gramm- und nicht systemspezifisch ist. Nur er 
kann in Applikationen verwendet werden, alle 
anderen müssen in besonderen dynamische Link- 
Libraries implementiert werden! [1]. 

Wie bereits oben erwähnt, funktioniert beim 
Anzeigen von modalen Dialogfeldern nicht die 
Tastaturbedienung des Hilfetextfelds. Normaler- 
weise müßte sich dies durch einen vorsichtigen 
Einbau der Funktion IsDialogMessage in die 
Funktion des Systemeingriffs lösen lassen. Leider 
sperrt sich dagegen aus unerklärlichen Gründen 
die Windows-Funktion DialogBox. Sie weigert 
sich in Zukunft, bestimmte vorhandene Fenster 
zu finden. Es wurden unzählige Varianten aus- 
probiert, aber die Fehlerursache und insbeson- 
dere die Vermeidung wurde nicht gefunden. Zu 
wenig Informationen über die Systemeingriffe 
und die Semantik der modalen Dialogfelder ver- 
bieten eine analytische Lösung. Mich würde es 
freuen, wenn einer der Leser eine Lösung dazu 
finden würde. 


Bewertung und Ausblick 


Das vorgestellte Hilfemodul wurde entwickelt, 
um einige der Forderungen an die Soforthilfe 
unter MS-Windows weitgehend applikations- 
unabhängig zu entwickeln. Es sollte sich dabei 
nicht um eine umfassende, voll einsatzfähige 
Lösung handeln, sondern vielmehr um eine Art 
Prototyp, mit dem untersucht wurde, inwieweit 
die Möglichkeiten von Windows (Systemeingrif- 
fe, Menünachrichten etc.) eine Implementierung 
ermöglichen. Dies ist meiner Auffassung nach 
weitgehend gelungen: Windows bietet viele Fea- 
tures, die die Entwicklung eines applikationsun- 
abhängigen Moduls erheblich erleichtern. Die 
Forderung nach einer Trennung der Organisation 
der Hilfestruktur und der Hilfetexte einerseits 
und dem Applikations-Programmcode anderer- 
seits konnte vollständig realisiert werden: Die 
Ressourcen-Implementierung von Windows ist 
vielseitig, einigermaßen transparent und relativ 
effizient, da sie auf der Windows-Speicherver- 
waltung aufbaut. Als etwas problematisch haben 
sich die geringen Fähigkeiten des Ressourcen- 
Compilers erwiesen, die zu einer teilweise recht 
langatmigen Beschreibung der Hilfedaten in der 
Ressourcen-Datei führten. Überhaupt ist die Er- 
zeugung der Hilfedaten im Augenblick über die 
Zerlegung der Datei HELP.TXT etwas umständ- 
lich. Ich plane daher die Entwicklung eines Gene- 
rators, welcher aus einer Hilfetextdatei die ein- 
zelnen Hilferessourcen automatisch erzeugt und 
ohne Verwendung des Ressourcen-Compilers die 
generierten Ressourcen in die EXE-Datei der 
Applikation einbindet. Diese Textdatei enthält 
auch alle für die Struktur und die Zuordnung er- 
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forderlichen Schlüsselwörter, Verweise etc., so 
daß die Wartung und Erweiterung und insbe- 
sondere die Übersetzung in andere Sprachen 
ziemlich einfach wird. Der Text wird im Rich- 
Text-Format erstellt [4], so daß auch verschie- 
dene Schriftgrößen, Attribute wie Unterstreichen 
oder vielleicht sogar die Einbindung von Grafik 
in die Hilfetexte möglich werden. 

Verbesserungsbedürftig ist auch die Präsenta- 
tion des Hilfemoduls für den Benutzer. So sollten 
die Texte in kleinerer Proportionalschrift 
(Helvetica) angezeigt werden, nicht nur weil 
diese besser lesbar ist, sondern auch, weil auf 
kleinerem Raum mehr Information unterge- 
bracht werden kann. Die Excel-Implementierung 
von Querverweisen und Glossarbegriffen fehlt 
ebenfalls noch. Auch ein Inhaltsverzeichnis als 
Alternative zum Index müßte integriert werden. 
Ein weiteres Problem stellt der Index dar: Bei 
größeren Applikationen besitzt er schnell ein 
paar Hundert Einträge. Auf diese kann man 
natürlich nicht mehr sinnvoll durch Blättern in 
einem Listenfeld zugreifen. Man muß vielmehr 
ein Schnellzugriff vorsehen, für den beispiels- 
weise die ersten drei Buchstaben eines ge- 
wünschten Begriffs eingegeben werden. Ferner 
kann man sich die Implementierung von 
»Lesezeichen« vorstellen, die der Benutzer sich 
selbst für Hilfeseiten anlegen kann, in denen er 
öfters nachschlägt. Als weitere Verbesserung der 
Hilfeverwaltung würde sich das Einbinden von 
Hilfetexten durch den Benutzer selbst anbieten, 
so daß dieser sich seine eigenen Hilfetexten zu 
seinen persönlichen Problemen mit einem Pro- 
gramm schreiben könnte, so wie er heute in sei- 
ner Dokumentation Anmerkungen an den Rand 
schreibt oder lose Blätter einlegt. 

All diese Verbesserungen betreffen jedoch 
nicht das vorgelegte Konzept der Speicherung 
der Hilfeinformation in Ressourcen und nur in 
geringem Umfang die benötigten Fähigkeiten des 
Windows-Systems. Es sind vielmehr Verbesse- 
rungen, die weitgehend im Hilfe-Modul selbst 
durchgeführt werden müssen und somit auch 
nicht den Quellcode der zugrundeliegenden 
Applikation berühren. Die Verbesserungen am 
Hilfemodul lassen sich mit wenig Aufwand somit 
mit einem Schlag in alle Applikationen über- 
nehmen. Damit ist noch einmal abschließend ge- 
zeigt, wie sinnvoll die Verlagerung der Sofort- 
hilfe in ein eigenes Modul ist. 


Marcellus Buchheit 
[1] Microsoft Windows System Development-Kit, 
Version 2. 


[2] Welch, K.P.: Die Mehrfachdokumentenschnittstelle 
(MDI), Microsoft System Journal, Juli/August 1989, 
Seite 5 bis 33. 

[3] Buchheit, Marcellus: Einführung in Fenster- 
unterklassen, Microsoft System Journal, März/April 
1989, Seite 67 bis 81. 

[4] Andrews, Nancy: Rich-Text-Format: Ein Standard 
erleichtert den Textaustausch. Microsoft System 
Journal, November 1987, Seite 75 bis 81. 


case WM VSCROLL: 
switch (uPl) 
(case SB_TOP: 
i=1; break; 
case SB_BOTTOM: 
i=iTextlen; break; 
case SB_LINEDOWN: 
i=min(iTextPos#+1,iTextlen); break; 
case SB_LINEUP: 
ismax(iTextPos-1,1); break; 
case SB_PAGEDOWN: 
i=min(iTextPos+10,iTextLen); break; 
case SB_PAGEUP: 
i=max(iTextPos-10,1); break; 
case SB_THUMBPOSITION: 
i=P2L0; break; 
default: 
/* ignore */ 
return FALSE; 
} /* switch */ 
/* send scrolling command to edit field */ 
if (il=iTextPos) 
{SendDlgItemMessage 
(hw, 1DTEXT,EM_LINESCROLL,O,MAKELONG(1-iTextPos,0)); 
iTextPos=i; 
SetScrollPos(GetDlgItem(hw, IDTXSRL),SB_CTL,iTextPos, TRUE); 
rzr it r 
return FALSE; 
case WM COMMAND: 
switch (uP1) 
{case IDPREV: 
if (iCurHelpfext<=iTextFirst) 
(/* at start of table: invalid selection */ 
MessageBeep(0); 
} 


else 

(/* load predecessor help-text if possible */ 
i=iCurHelpText-1; 
if (LoadHelpText(hw,i)) iCurkelpText=i; 
1 Sell de / 

break; 

case IDNEXT: 

if (iCurHelpfext>=iTextLast) 

(/* at end of table: invalid selection */ 
MessageBeep(0); 

} 


else 
{/* load successor help-text if possible */ 
i=jCurHelpfext+1; 
if (LoadHelpText(hw,i)) iCurHelpText=i; 
N ArR At / 
break; 
case 1DOK: 
case IDCANCEL: 
/* close modeless index dialog box */ 
DestroyWindow(hw); hwDbxHelp=NULL; iHelpMode=HPM NONE; 
FreeProcInstance(rfdHelp); 
if (uPl==100K) SetindexHelp(); 
return TRUE; /* consumed */ 
} /* switch */ 
break; 
} /* switch */ 
return FALSE; 
} /* fdHelpText() */ 
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SwitchindexHelp 

This function activates the index help. 
Parameters: 

none 

Return: 


none 
ee 


static VOID SwitchIndexHelp(VOID) 


{switch (iHelpMode) 
{case HPM_NONE: 
iCurHelpText=0; Setindexkelp(); itelpMode=HPM_INDEX; break; 
case HPM_INDEX: 
/* activate context help window */ 
SetFocus(hwDbxHelp); break; 
case HPM_CONTEXT: 
ResetHelp(); SetIndexHelp(); break; 
} /* switch */ 
} /* SwitchIndexHelp() */ 


F Aeinhehuiehheehahehehuhahe hehe halaheiu einher he he hehe beheben heisse een ee ehe 
SwitchContextHelp 

This function activates the context help with the help text 
<iHelpText>. 

Parameters: 

iNewText .. is the index of the new help text. 

iAreafirst is the first value of the current help text area. If this 
is 0, for both bound values a default area is used. 

is the last value of the current help text area. If the 
value is 0, a default value is used. 


iArealast 


Return: 


none 
—.— Re / 


static VOID SwitchContextHelp 
(int iNewText,int iAreafirst,int iArealast) 


{/* set first and last bound of current help text area */ 
if (iAreafirst==0) 
1/* use default values */ 
if (iNewText>=HTX_FIRST &8 iNewText<HTX_SPECIAL) 
{/* standard help text area (general, menu etc) */ 
iTextFirst=HTX_FIRST; iTextLast=GetTextIndex(0); 
} 


else 
{/* no range */ 
iTextFirst=iNewText; iTextlast=iNenText; 
rPirn 
} 
else 
{/* set both values */ 
iTextFirsteiAreafirst; iTextlLast=iArealast; 
Far 
switch (iHelpMode) 
{case HPM_NONE: 
SetContextHelp(iNewText); break; 
case HPM_INDEX: 
ResetHelp(); SetContextHelp(iNewText); break; 
case HPM_CONTEXT: 
/* change text if needed, activate context help window */ 
if (iCurHelpText) 
{/* change help text */ 
LoadHelpText (hwObxHelp,iNewText); iCurHelpText=iNewText; 
ri 
SetFocus(hwDbxHelp); break; 
} /* switch */ 
} /* SwitchContextHelp() */ 
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HpmProcessHelpMsg 


EERSESESEERSEEENSEESEEEETEERSERESSEHUEEHENRENEREESESEREERTRENEEEEREEEE 


This function processes all messages which are received by the 
application window function if they are of interest for the help 
manager. 


Parameters: 

hw „. is the window handle of the application window. 

iMsg is the message which was received by the application window 
function. 

uPl is the word parameter of the message. 

ulP2 is the long word parameter of the message. 


Return: 
If a non-zero value is returned, the function has consumed the 
message. Otherwise the standard function DefWndProc must be called. 


ee / 


LONG HpmProcessHelpMsg(HWND hw,WORD iMsg,WORD uP1,DWORD ulP2) 


{8YTE z[S_CMD_DESCR+1]; 
WORD uHcs=0; 


switch (iMsg) 
{case WM _MENUSELECT: 
if (PZHII=NULL) 
tif (P2LO&MF_POPUP) 
{/* popup-window header: get code of first command in menu */ 
uHcs=GetMenultemID(uP1,0); 


} 
else if (P2HII=NULL) 
{/* menu command selected: determine description string */ 
uHcs=uPl; 
I a 3 
iMenuCmd=uHcs; /* command code of menu */ 
if (P2LOBMF_POPUP) iMenucmd—; /* popup-code */ 
year 
if (uHcs>=0xF000 && P2LORMF_SYSMENU) 
{/* determine predefined entries in system menu */ 
iMenuCmd=uHcs; /* command code of menu */ 
switch (ulcs) 
{case SC_RESTORE: 
uhcs=HCS_SYSREST; break; 
case SC_MOVE: 
uHcs=HCS_SYSMOVE; break; 
case SC_SIZE: 
uHcs=HC$_SYSSIZE; break; 
case SC_MINIMIZE: 
ukcs=HCS_SYSMIN; break; 
case SC_MAXIMIZE: 
uHcs=HCS_SYSMAX; break; 
case SC_CLOSE: 
uHcs=HCS_SYSCLOSE; break; 
default: 
uHcs=0; break; 
} /* switch */ 


else 

{/* other command: convert to help command string */ 
uHcs+=2000; 

2 had he? 3 


«Listing 7: 
if (uHcsi=0) Fortsetzung 
{/* command exists: load description string */ 
if (P2LOBMF_POPUP) ulics—; /* use predecessor for popup */ 
LoadString(hiMain,ukcs,z,sizeof(z)); 


else 

{/* string is empty */ 

z[0]=0; 

ı FIR 
/* send string to command description line */ 
SethindowText(hwLine,z); 
break; 

case WM COMMAND: 

if (uPl==CMD_HELP_INDEX) 

1/* switch index help (on/off) */ 

SwitchIndexkelp(); 


} 
else if (uPl==CMD HELP CONTEXT) 
{/* activate context help: currently not implemented */ 
Ye, 
break; /* not consumed */ 
} /* switch */ 
return OL; /* not consumed */ 
} /* HpmProcessHelpMsg() */ 
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SwitchDialogHelp 
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This function finds the help text for the current selected dialog box 
item. If it is found the help text is displayed and TRUE is returned. 
Otherwise FALSE is returned. 


Parameters: 
none 
Used variables: 
iCurD1gBox,iCurDigitem 
Return: 
none 
Ku u u u u a he I he ba en a hl a haha ki ba neh ehe] 


static int SwitchDialogHelp(VOID) 


{HANDLE hTab; 
WORD FAR *ru; 
int iFirst,ilast,iText; 
BOOL bLastDlg; 
HWND hw; 
hTab=FindResource 
(hiMain,MAKEINTRESOURCE (HLS_DIALOG) „MAKEINTRESOURCE (RT_RCDATA)); 
if (hTab) hTab=LoadResource(hiMain,hTab); 
if (IhTab) return 0; /* not found or memory too small */ 
/* get index of help text via resource table (type RCDATA) */ 
ru=(WORD FAR*)LockResource(hTab); 
hw=GetFocus(); /* assumed that selected item in dialog box */ 
/* window must be child window otherwise no dialog item */ 
if (!(GetWindowLong(hw,GWL_STYLE)SWS_CHILD)) return FALSE; 
/* read ident of child window */ 
iCurDigItem=-GetWindowWord (hw,GWW_1D) ; 
/* search item in table */ 
bLastDIg=FALSE; iText=0; 
do 


{if (*rul=iCurDlgBox && *ru) 
{/* skip dialog box area */ 
rut+t; /* skip dialog box ident */ 
while (*ru) rur=2; /* skip items of dialog box */ 
ru+t+; /* skip end of dialog box area */ 
} 


else 
{/* dialog box matched: find item */ 
if (!*ru) blastDIg=TRUE; /* default box => last chance */ 
ru++; /* skip dialog box ident */ 
iFirst=*(rutl); /* first element in dialog box text area */ 
/* check if dialog item matches */ 
while (*ru) 
{/* search item */ 
if (*ru==iCurDlgItem) 
{/* item found => get ident of help text, exit loop */ 
iText=*(rutl); 
/* search last element */ 
while (*ru) ru+=2; /* skip items of dialog box */ 
iLast=*(ru-1); /* get last element of dialog box text area */ 
goto Found; /* entry is found */ 
ir ite 
rut=2; /* next item */ 
} /* while */ 
rutt; /* skip end of dialog box area */ 
ERAT 


} 
while (!blastDlg); 
Found: 
UnlockResource(hTab); FreeResource(hTab); 
if (iTexti=0) 
{/* help text found: display it */ 
if (bLastDig| |iText<HTX_SPECIAL) 

{/* no range possible or general text */ 

iFirst=0; 

KEITH 
SwitchContexthelp(iText,iFirst,ilast); return TRUE; /* found */ 
PER, 

return FALSE; 
} /* SwitchDialogHelp() */ 
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{HANDLE hTab; 
WORD FAR *ru; 
int iText; 
BOOL blLastDlg; 
if (tiCurMsgString) return FALSE; 
hTab=FindResource 
(hiMain,MAKE INTRESOURCE (HLS_MESSAGE) „MAKEINTRESOURCE(RT_RCDATA)); 
if (hTab) hTab=LoadResource(hiMain,hTab); 


SwitchMenuHelp 
This function finds the help text for the current selected menu. If it /* no string */ 
is found the help text is displayed and TRUE is returned. Otherwise 
FALSE is returned. 


Parameters: if (1hTab) return 0; /* not found or memory too small */ 
none /* get index of help text via resource table (type RCDATA) */ 
Return: ru={WORD FAR*)LockResource(hTab); iText=0; 

none while (*ru) 


BR / {/* outer loop: search selected message string */ 
if (*rur1=ilurMsgString) 
{/* skip message string area */ 
while (!*ru) 
(/* skip dialog box area */ 
rut+; /* skip dialog box ident */ 
while (*ru) rut=2; /* skip items of dialog box */ 
rut+; /* skip end of dialog box area */ 
} /* while */ 


static int SwitchMenuHelp(VOID) 
{HANDLE hTab; 
WORD FAR *ru; 
hTab=FindResource 
(hiMain,MAKEINTRESOURCE (HLS_MENU) „MAKEINTRESOURCE (RT_RCDATA)); 
if (hTab) hTab=-LoadResource(hiMain,hTab); 
if (!hTab) return 0; /* not found or memory too small */ 


/*” get index of help text via resource table (type RCDATA) */ rut+; /* skip end of message string area */ 
u=(WORD FAR*)LockResource(hTab) ; } 
while (*ru) else 


{if (*ru==iMenuCmd) break; /* command found */ {/* message string matched: find dialog box & item */ 
rut=2; /* next pair */ bLastDlg=FALSE; 

} /* while */ do 

UnlockResource(hTab); FreeResource(hTab); {if (*rul=iCurDigBox && *ru) 

if (*ru==iMenulmd) {/* skip dialog box area */ 

{/* help text found: display it */ rutt; /* skip dialog box ident */ 


SwitchContextHelp(*(ru+1),0,0); return TRUE; /* found */ while (*ru) rut=2; /* skip items of dialog box */ 
ri rut+; /* skip end of dialog box area */ 
return FALSE; } 


else 
{/* dialog box matched: find item */ 
if (!*ru) bLastDig=TRUE; /* default box => last chance */ 


} /* SwitchMenukelp() */ 


Jereseseieeanit seen 


SwitchMessageHelp rutt; /* skip dialog box ident */ 
BenunsnnnnnnoSwSnnnnuSnnsanseseunseesnnunseenensesonssunsuunsunnnnunern /* check if dialog item matches */ 
This function finds the help text for the current displayed message while (*ru) 

box. If it is found the help text is displayed and TRUE is returned. (/* search item */ 

Otherwise FALSE is returned. if (*rus=ilurDigltem) 


Parameters: {/* item found => get ident of help text, exit loop */ 
none iText=*(ru+l); goto Found; 

Used variables: PIE 

iCurDigBox, iCurDigItem rut=2; /* next item */ 

Return: } /* while */ 

none rut+; /* skip end of dialog area */ 


A / 


static int SwitchMessageHelp(V010) } 
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while (!bLastDig); 
1 Au 5 A 
} /*" while */ 
Found: 
UnlockResource(hTab); FreeResource(hTab); 
if (iText!=0) 
(/* help text found: display it */ 
SwitchContextHelp(iText,0,0); return TRUE; /* found */ 
) Zr itr) 
return FALSE; 
} /* SwitchMessageHeip() */ 
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fhMsgFilter 
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### Hook filter procedure #44 


This function is the filter function for all dialog-box/message-box/ 
menu messages to check if a help-manager button is pressed. 


If the WM_KEYDOWN message is received and the key VK_Fl is pressed, 
the context help is displayed or actualized. 
AI] others messages are not consumed. 


Me RA / 


DWORD FAR PASCAL fhMsgFilter(int iCode,WORD uP,MSG FAR *rwm) 
fint iMsg; 


if (iCode>=0) 
(iMsgerum->message; /* current message */ 
if (iMsg=-WM_KEYDOWN && rwm->wParam==VK_FI && rwn->hwnd!=hwübxHelp) 
{/* Fi-button pressed: activate/change help */ 
switch (iCode) 
{case MSGF_DIALOGBOX: 
/* determine help text/dialog box entry and display it */ 
if (SwitchDialogHelp()) 
{/* message consumed */ 
rwm->message=WM NULL; return OL; 
ISCH 
break; /* not consumed */ 
case MSGF_MENU: 
/* determine help text/current menu entry and display it */ 
if (SwitchMenukelp()) 
{/* message consumed: close menu by replacing Fi by ESC */ 
rem->message=WM_KEYDOWN; rwn->wParam=VK_ESCAPE; return OL; 
yyeire 
break; /* not consumed */ 


« Listing 7: 
case MSGF_MESSAGEBOX: Fortsetzung 
/* determine help text/current message box and display it */ 
if (SwitchMessageHelp()) 
{/* message consumed */ 
rmm->message=WM NULL; return OL; 
IE g 
break; /* not consumed */ 
} /* switch */ 
RR 
ER NY 
/* not processed > use default */ 
return DefHookProc 
(iCode,uP,LADDR(rwm) „(FARPROC FAR*)ärfhPrevMsgFilter); 
} /* fhMsgFilter() */ 
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This function checks if the message [*rwm] is for the help manager. 
If so the message is processed and TRUE is returned. 
Otherwise FALSE is returned. 


Parameters: 
rwm is the address of the window message. 


Return: 
TRUE if the message was processed by the help manager 
and FALSE if not. 


MER / 


BOOL HpmCheckMessage(LPMSG rum) 


{BOOL b=FALSE; 

if (hwObxHelp) 
{/* check if help dialog box message */ 
b=1sDialogMessage (hwübxHelp,rwm) ; 
I/r it 

return b; 

) /* HpmCheckMessage() */ 


[ern 
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This APRES sets the environment constants for the message box which 
is displayed in near future. The values are used if the user presses the 
[SHIFTJ[F1] keyboard combination to get help about the message. 
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Mit diesem Buch wird Ihnen in 
leichtverständlichen Arbeits- 
schritten der Einstieg in das 
neuartige Planungssystem er- 
leichtert. Im Anhang finden Sie 
Übungsaufgaben zu den einzel- 
nen Kapiteln. Alle Übungsbei- 
spiele mit den Lösungen sind 
auf der mitgelieferten Beispiel- 
diskette enthalten. 

1988, 183 Seiten, inkl. Diskette 
Bestell-Nr. 90515 

ISBN 3-89090-515-3 

DM 69,- (sFr 63,50/öS 538,-) 


Er Lehr und Arbeitsbuch 


EDITION 


R.Haselier/K.Fahnenstich 
Programmieren mit Quick C 
Dieses Buch zeigt Ihnen, wie 
Sie mit Quick C schnell und 
komfortabel eigene Programme 
erstellen können. 

« Für den C-Einsteiger ebenso 
wie für den Fortgeschrittenen. 
1988, 412 Seiten, 

inkl. zwei Disketten 

Bestell-Nr. 90609 

ISBN 3-89090-609-5 

DM 69,- (sFr 63,50/öS 538,-) 


Marktäftechnik 


DICK € 
TOOLBOX 


a BAU Ban DAN EEE ER dust 


rtengreschen booiten tur Rente ung 107 
Softmare-Scrnrintener 


EDITION 


R.Haselier/K.Fahnenstich 
Quick C Toolbox 

Neben einer Beschreibung des 
Standards finden Sie alles, was 
Sie schon immer in Ihrer C-Bi- 
bliothek vermißt haben. Für 
Quick C, Version 1.01 und Micro- 
soft C, Version 5.1. 

Lieferbar 1.Quartal 1989, 
ca.200 Seiten, 

inkl. drei 5'/4”-Disketten 
Bestell-Nr. 90674 

ISBN 3-89090-674-5 

ca. DM 98,-*- (sFr 90,20*/ 

ÖS 834,-*) 


Einführung und Überblick 


EDITION 


Dr. N. Meder/G.König/ 
P.Scheuber MS-OS/2 

Dieses erste Buch der Edition 
Microsoft gibt Ihnen - als erfah- 
renem Anwender oder PC-Soft- 
ware-Entwickler - einen Ein- 
stieg und einen Überblick über 
das neue Betriebssystem MS- 
OSI/2l 

Die Installation und die ersten 
Schritte werden ausführlich 
beschrieben. Den Schwerpunkt 
bildet der neue Befehlsvorrat 
von MS-OSI2. 

1987, 304 Seiten 

Bestell-Nr. 90512 

ISBN 3-89090-512-9 

DM 79,- (sFr 72,20/öS 616,-) 


“ur 


11°C 35 2 
+ Soft yelfs= 
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EDITION 


Dr. F.M.Sonner/M.Theis 
MS-OS/2 für Software- 
Entwickler 

Im ersten Teil des Buches wer- 
den Themenkomplexe behan- 
delt wie Speicherverwaltung, 
Multitasking und Programmier- 
schnittstelle. Im zweiten Teil fin- 
den Sie praktische Program- 
mierbeispiele, und der dritte Teil 
enthält einen ausführlichen 
Referenzteil. 

1988, 246 Seiten 

Bestell-Nr. 90638 

ISBN 3-89090-638-9 

DM 79,- (sFr 72,20/6S 616,-) 


* Unverbindliche Preisempfehlung 


Markt & Technik-Produkte 

erhalten Sie in den Fachabteilungen 

der Warenhäuser, im Versandhandel, 

in Computer-Fachgeschäften oder gen 
bei Ihrem Buchhändler. IE 


Fragen Sie Ihren Fachhändler 
nach unserem kostenlosen Gesamtverzeichnis 
mit über 500 aktuellen Computerbüchern 
und Software. Oder fordern Sie es direkt 
beim Verlag an! 


> Listing 7: 
Ende 


>> Listing 8: 

Die Datei HELP.TXT 
enthält alle Hilfe- 
texte, die von SHAPE 
verwendet werden. 
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Parameters: 

iltem is the ident of the item in the dialog box or 0 if no 
special item is selected. 

iString is the ident of the string which is displayed in the 
message box. If this value is 0, no help can be chosen about 
the displayed message (for example if memory to small). 


Return: 
none 


ee / 


VOID HpmSetMsgBoxEnv (WORD iItem,WORD iString) 


{/* set values to module variables */ 
iCurDigItemsiltem; ilurMsgString=iString; 
} /* HpmSetMsgBoxEnv() */ 


T Auicieieisielshsäsheiuieleieheislalstoisiekeisihstnlelshshukeinlahshsinichsäskuiniekeäsheinkoishekshehetstshnickuhaheistusisheinknknbehel 


HpmSetDIgBoxEnv 


SSEEEIESSEEIEDEUERTERESENNEEERBEUEREENEENENESERTEESHENENEREEREREREREnEE 


This function sets the identification value of the current used dialog 
box. 

This is the value of the resource file description of the dialog box. 
The value is used if the user presses the [SHIFTJ[FI] keyboard 
combination to get help about the current dialog item of a message 
string. 


Parameters: 
iDIgBox is the ident of the dialog box or 0 if no special 
dialog box is selected, 


Return: 
none 


ee / 


VOID HpmSetDlgBoxEnv(WORD iDIgBox) 


{/* set value to module variable */ 
iCurD1gBox=iD01gBox; 
} /* HpmSetDlgBoxEnv() */ 


F Eiclebeisisleisielnkeleinieksisleiskehioiskaishsheieksistskshsialsisksteiuteleheieeisiehskelsinkeinhshinielniehsbsheiabelelshsteleiehed 


HpmInit 


ESEHEISEEEEZENENENTNENERSENNUNTSERERNERREERESEESSEERESEERSEnSEenunenen 


This function initializes the help manager. If creates a small child 
window at the left bottom corner of the client area of the window 
<hwAppl>. 


Parameters: 

hwAppl is the window handle of the application in which client area 
the help manager's command description line is displayed. 

hiAppl is the module instance handle of the application. 


Return: 
TRUE if help manager is initialized FALSE if not. 


EZ 


BO0L HpmIinit(HWND hwApp!,HWND hiApp!) 


{TEXTMETRIC wtm; 
HDC hdc; 


hwMainshwAppl; /* store window handle of application's menu */ 
hiMain=hiAppl; /* set instance of application */ 
/* determine size of standard display characters */ 
hdc=CreateIC("Display“ .NULL,NULL,NULL) ; 
GetTextMetrics(hdc,&wtm) ; 
sxChar=wtm.tmAveCharkidth; syChar=wtm.tmHeight; 
DeleteDC(hdc) ; 
/* create command descriptor line window */ 
hwLine=CreateWindow 
("static","",WS_BORDER|SS_LEFT|WS_CLIPSIBLINGS|WS_CHILD, 
0,0,5_CMD_DESCR*sxChar,syChar+4,hwApp! ‚NULL,hiApp] „NULL 
) 
if (IhwLine) return FALSE; /* not created => error */ 
/* set subclass for text browsing */ 
rfwSubEdit=MakeProcInstance((FARPROC) fwSubEdit,hiMain); 
/* set hook function for dialog-box/menu/message-box analysing */ 
rfhMsgFilter=MakeProcInstance((FARPROC) fhMsgFilter,hiMain); 
rfhPrevMsgFilter=SetWindowsHook(WH_MSGFILTER, rfhMsgFilter); 
return TRUE; 
} /* Hpminit() */ 


|* zuunnsunannnennnuannennnnenee 


End of WINDOWS module HELPMGR 
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VEREINTEN TEN EITEETHHTETTAINDEXN.HTX 
Applikation 

Farbe 

Fr] Imuster 


Applikation 
Die Applikation SHAPE dient zum Anzeigen festgeleg- 
ter geometrischer Elemente. Es k+nnen verschiedene 
Darstellungseigenschaften fr die Elemente gew£hlt 
werden, so die Gr+Me und Farbe und das Muster, mit 
der sie gef"ilt werden. 
ETIEEAETEITTESSEHOBJECT.HTX 
Objekte 
Mit SHAPE k+nnen folgende Objekte gezeichnet wer- 
den: Ellipse, Raute und (Ellipsen-)Sektor. Es wird 
jeweils nur eines der gezeichneten Objekte ange- 
zeigt, dieses allerdings in einstellbarer Gr+Me 
und Farbe und das F"iimuster kann ausgewihlt wer- 
den. Die Auswahl des Objekts geschieht im Men” 
„Zeichnenk, die anderen Einstellungen erfolgen im 
Men" „Optionen. 
EEE SLISSMNUDRAN .HTX 
Men" Zeichnen 
Mit Hilfe dieses Men”s k+nnen folgende Objekte ge- 
zeichnet werden: Ellipse, Raute und (Ellipsen-) 
Sektor. Hierbei wird das Objekt in der eingestell- 
ten Gr+Me und Farbe gezeichnet und das ausgesuchte 
Frllmuster verwendet. 
EEETETTTNTTTTTEHTEPTACMDELIP.HTX 
Befehl „Ellipse% 
Mit diesem Befehl wird eine Ellipse in der ein- 
gestellten Farbe gezeichnet und mit dem eingege- 
benen F"ilmuster ausgef"llt. Die Breite und H+he 
der Ellipse ergibt sich aus den eingestellten 
horizontalen und vertikalen Gr+#enwerten. 
TITEL STERTCMDRHOMB .HTX 
Befehl „Raute 
Mit diesem Befehl wird eine Raute in der ange- 
gebenen Farbe gezeichnet und mit dem angegebenen 
Frilmuster ausgef”llt. Die Breite und H+he der 
Raute ergibt sich aus den angegebenen hori- 
zontalen und vertikalen Gr+#enwerten. 
ET IA TETFETHRCMDSECT..HTX 
Befehl „Sektors 
Mit diesem Befehl wird ein halber Sektor einer 
Ellipse in der angegebenen Farbe gezeichnet 
und mit dem angegebenen F"]imuster ausgef"lit. 
Die Breite und H+he des Quadrats ergibt sich 
aus dem angegebenen horizontalen Gr+#enwert. 
Das Zeichnen gr+#erer Sektoren kann mehrere 
Minuten dauern! 
ITTTETETCHTTTITEHTETEHTSEHRZFSCHOMDEND..HTX 
Befehl JEndey 
Mit diesem Befehl wird die Applikation SHAPE 
beendet. f 
TITTTCETETESESFFTTFOPTION.HTX 
Optionen 
Mit SHAPE k+nnen die Objekte in verschiedenem 
Erscheinungsbild gezeichnet werden. Es kann die 
Gr+@e des Objektes, die Farbe und das F"iimuster 
in beschrinktem Umfang eingestellt werden. Dies 
geschieht mit Befehlen im Men" „Optioneny. 

IPT.HTX 
Men? „Optionen% 
Mit Befehlen in diesem Men" kann das Er- 
scheinungsbild des zu zeichnenden Objekts 
in beschrinktem Umfang eingestellt werden. 
Hierbei kann die Gr+Me des Objektes, die 
Farbe und das F"ilmuster in beschrinktem 
Umfang eingestellt werden. 
ETETTETTTETTETTRSIZE.HTX 
Gr+#e 
Mit SHAPE k+nnen die Objekte in unterschiedlicher 
Gr+®e gezeichnet werden. Hierzu ist im Men" 
„Optioneny der Befehl „6r+®e% zu wIhlen, 
EITHER TRSSCHDS TZE.HTX 
Befehl zGr+Me% 
Dieser Befehl ruft ein Dialogfeld aus, mit dem 
die Objektgr+Me f"r die weiteren Zeichenopera- 
tionen ausgewählt werden kann. Die Gr+Me wird 
horizontal und vertikal als Prozentwert der 
aktuellen Fenstergr+®e von SHAPE angegeben. 
Wird die Fenstergr+®#e verändert, Indert sich 
entsprechend auch die Gr+#e des gezeichneten 
Objekts. 
TITTTTTTITTTTTTTERTHHFTCOLOR.HTX 
Farbe 
Mit SHAPE k+nnen die Objekte in unterschiedlicher 
Farbe gezeichnet werden. Hierzu ist im Men” 
„Optionens der Befehl „Farbek zu wIhlen. 
ITIITEITFESFSSSFHCMDCOLOR.HTX 
Befehl „Farbe% 
Dieser Befehl ruft ein Dialogfeld auf, mit dem 
der Rot- Gr"n- und Blau-Anteil der Objektfarbe 
eingestellt werden kann. Der eingestellte Wert 
wird fPr die weiteren Zeichenoperationen ver- 
wendet. 


ITTTTTITESTRTAFTLL.HTX 
FP}imuster 

Mit SHAPE k+nnen die Objekte mit unterschiedlichen 
Mustern gef"ilt werden. Hierzu ist im Men” 
„0ptionens der Befehl „F"iimuster% zu wihlen. 
INTITLE LNLPENSSSCMDF ILL. HTX 
Befehl „F"lImuster% 

Dieser Befehl ruft ein Dialogfeld aus, mit dem 

das F]Imuster f"r die weiteren Zeichenopera- 
tionen ausgewihlt werden kann. Das F"limuster 

wird in der eingestellten Farbe erzeugt. Es 

kann zwischen leerem, diagonal gestreiften 

und vollem Frilmuster gewählt werden. 
WETTEN TLZSELSSPOOLLEAR.HTX 
Lrschen 

Ein gezeichnetes Element kann mit dem Befehl 
„l+schen% in der Men"leiste gel+scht werden. 
IILLIIPALCCLNILNOSLDEANLIILELLILLISSSSHCMDCLR..HTX 
Men"/Befehl „L+schen% 

Hiermit wird der Fensterinhalt gel+scht. Ein vor- 
her gezeichnetes Objekt wird entfernt. 
ETTTTTTETETTITTFTRETTIHELP.HTX 
Hilfe 

Das Programm ist mit einer leistungsfähigen Hilfe- 
funktion ausgestattet. Mit dem Befehl ;Hilfe-Index% 
im Men” „Hilfe wird der Index angezeigt, der 
Stichw+rter fPr bestimmte Probleml+sungen besitzt. 
Die Stichw+rter verweisen in eine Sammlung von 
Hilfetexten, die sequentiell miteinander verbunden 
sind. Der Hilfe-Index kann auch mit der Taste [Fl] 
angewihlt werden. 

Mit [Fi] kann innerhalb von Men"s, Dialog- und 
Hinweisfeldern Hilfe angefordert werden. Der ange- 
zeigte Hilfetext bezieht sich auf das Element, 
welches augenblicklich selektiert ist. 

Der Befehl „Kontexthilfes dient zur ErlZuterung von 
Dialogobjekten im Men” oder im Applikationsfenster 
(auch im Rahmen). Er ist z.Zt. nicht implementiert. 
TATETETTRTTTETTITTTTESTEEMNUHELP..HTX 
Menu Hilfe 

Dieses Men" wihlt die Soforthilfe aus. Es kann 
zwischen dem Hilfe-Index mit Schi"sselw+rtern und 
der Kontext-Hilfe gewählt werden. 

TA SEAETEEFPEFPSTSCMOHPIX..HTX 
Befehl ;Hilfe-Index% 

Dieser Befehl zeigt eine Liste von SchI"sselwtr- 
tern, die Anwendungsprobleme oder allgemeine Fakten 
betreffen. Nach der Auswahl eines der SchI"sselw+r- 
ter wird der entsprechende Hilfetext angezeigt. Von 
diesem Text aus kann durch Vor- und Zur"ckblZättern 
verwandte Informationen im Hilfeverzeichnis abge- 
rufen werden. 
BRREIEEETEICCTTITTETTTTTTTHTIÄCMDHPCTK..HTX 
Befehl „Kontexthilfe% 

Der Befehl ist zur Zeit nicht implementiert. Später 
verwandelt er den Mauszeiger in einen Zeiger mit 
Fragezeichen, mit dem die Bedeutung von Feldern 
innerhalb des Applikationsfensters, des Men”s oder 
auch des Fensterrahmens erfragt werden k#+nnen. 
ICTITICTTCCTCTNTTTTLTETTEEHHVERT .HTX 
Textfeld „Vertikal 

Mit diesem Feld wird die vertikale Gr+Me des zu 
zeichnenden Objekts bestimmt. Sie wird als Prozent- 
wert der vertikalen Fensterinhalts angegeben. 
Zulissig sind ganzzahlige Werte zwischen 0 und 100. 
TTITLENEITLATTLCCLLEALLIDSLCASHORZ .HTX 
Textfeld „Horizontal 

Mit diesem Feld wird die horizontale Gr+Me des zu 
zeichnenden Objekts bestimmt. Sie wird als Prozent- 
wert der vertikalen Fensterinhalts angegeben. 
Zulfssig sind ganzzahlige Werte zwischen 0 und 100. 
ET TTTITTETTETTETTNTTISSTZEOK.HTX 
Schaltfläche „0K% 

Hiermit wird die Eingabe des Dialogfelds abgeschlos- 
sen und die eingestellen Gr+#enwerte f"r das nach- 
folgende Zeichnen von Objekten abgespeichert. 
TITTTITETTTNETTANRHTRRED.. HTX 
Rolleiste „Rots 

Hiermit wird der Rotanteil f"r das Objektzeichnen 
eingestellt. Er kann zwischen 0 f"r schwarz "ber 50 
f"r halben Grauanteil bis zu 100 f"r sattes Rot 
eingestellt werden. Die aktuelle Prozentwert wird 
rechts von der Rolleiste angezeigt. 
TITTETTETLAHELTZZPSSSAGREEN..HTX 
Rolleiste ;6r"n% 

Hiermit wird der Gr"nanteil f"r das Objektzeichnen 
eingestellt. Er kann zwischen 0 f"r schwarz "ber 50 
f”r halben Grauanteil bis zu 100 f"r sattes Gr"n 
eingestellt werden. Die aktuelle Prozentwert wird 
rechts von der Rolleiste angezeigt. 
EITTETTNANNALTTECCHTHRSHBLUE.HTX 
Rolleiste „Blaus 

Hiermit wird der Blauanteil f"r das Objektzeichnen 
eingestellt. Er kann zwischen 0 f"r schwarz "ber 50 
f"r halben Grauanteil bis zu 100 f"r sattes Blau 
eingestellt werden. Die aktuelle Prozentwert wird 
rechts von der Rolleiste angezeigt. 
ENTE EIRITGTTTITEHTCOLOROK.HTX 
Schaltfläche „0K% 

Hiermit wird die Eingabe des Dialogfelds abge- 
schlossen und die eingestellen Farbenwerte f"r das 
nachfolgende Zeichnen von Objekten abgespeichert. 


ECHTEN ALESSI LL .HTX 
Rundes Optionsfeid ;Muster 1% 

Hiermit wird angegeben, da®@ das zu zeichnende Ob- 
jekt nicht gef"]It werden soll sondern der Fenster- 
hintergrund im Innern des Objekts erscheint. 
HTCLPSHSCIIEILLELLLLLNELLELLASSFILLZ .HTX 
Rundes Optionsfeld „Muster 2% 

Hiermit wird angegeben, da®@ das zu zeichnende Ob- 
jekt mit einem schraffierten Muster gef”Ilt werden 
soll. Das Muster besitzt die rechts angegebene 
Farbe. Ist das Muster nicht sichtbar, ist die 
Hintergrundfarbe als Objektfarbe gewählt worden und 
das Objekt somit beim Zeichnen nicht sichtbar. 
TETTTTATEETEETTETAETTHETRETRRFILLI.HTX 
Rundes Optionsfeld „Muster 3% 

Hiermit wird angegeben, da® das zu zeichnende 
Objekt mit einem gleichmi@igen Farbton gef"lit 
werden soll. 
EECLTILECELCLLLLLLOLLOECLZLCELELESCOHFILLOK..HTX 
Schaltfläche z0K% 

Hiermit wird die Eingabe des Dialogfelds abge- 
schlossen und das eingestelle F"lImuster fr das 
nachfolgende Zeichnen von Objekten abgespeichert. 
EITTITTITTEITTTEITTTTTCCHTTTTTHCAÄNCEL. HTX 
Schaltfläche „Abbruch% 

Hiermit wird die Eingabe des Dialogfelds abge- 
schlossen, die eingestellten Werte aber verworfen 
und nicht "bernommen. 
CINCH SSSHORZVAL .HTX 
INlegaler numerischer Wert 

Der Horizontal-Wert muf@ ein ganzzahliger numeri- 
scher Wert im Bereich von 0 bis 100 sein. Andere 
Werte oder nichtnwmerische Zeichen sind nicht 
zulZssig. 

EICHE ILCTLTATIETCOHSHAVERTVAL.HTX 
Tilegaler numerischer Wert 

Der Vertikal-Wert mu@ ein ganzzahliger numerischer 
Wert im Bereich von 0 bis 100 sein. Andere Werte 
oder nichtnumerische Zeichen sind nicht zulässig. 


Panik ichels kchlelshelshelokshelabshstulebchlehsinksishchsinhslatslchsielshiehshelebsteteishelehsleichsinieheieteksluieleh 


SPL LIT ——— D05-Application 
I ZZ ZZ ZZ ze ZZ ZZ zz zn Ze 
This program parses the file HELP.TXT into its single help text files. 
Copyright 1989 by Marcellus Buchheit, Buchheit software research 
All rights reserved. 
a 
#include <stdlib.h> 
#include <stdio.h> 
#include <string.h> 
|? zunnnnnszennn 
main function 
znesunennnnnet/ 
void main(V0ID) 
{FILE *rSrcfile; 
FILE *rDestFile; 
char zLine[80+1]; 
char rzFileName[80] ; 
char *rz; 
int nFiles=0; 
/* open source file */ 
rSrcfile=fopen("HELP.TXT","rt*); 
if (IrSrcFile) 
{/* file not opened: error message, abort */ 
printf("SPLIT: Cannot open file HELP.TXT.\n"); 
exit(2); /* unable to start operation */ 
1 SEN: 
fgets(zLine,sizeof(zLine)-1,rSrcfile); 
while (!feof(rSrcfile)) 
{/* skip '=' in header line, create dest. file, read help text */ 
rzezLine; /* pointer to start of line */ 
while (*rz=='%') rz+t+; 
if (rz[strlen(rz)-1]=='\n') rz[strien(rz)-1]=0; 
strepy(rzFileName,rz); 
rDestFile=fopen(rzFileName,"w+t"); 
if (IrDestFile) 
{/* file not created: error message, abort */ 
printf(*SPLIT: Cannot create file %s.\n",rzFileName); 
exit(2); /* unable to start operation */ 
ri 
fgets(zLine,sizeof(zLine)-1,rSrcFile); 
while (ifeof(rSrcfile) 88 zLine[0]!='%') 
{/* copy text to destination file */ 
fputs(zline,rDestFile); 
fgets(zLine,sizeoffzLine)-1,rSrcfile); 
} /* while */ 
/* close file */ 
fputc(26,rDestFile); 
if (fclose(rdestfile)) 
{/* cannot close destination file */ 
printf("SPLIT: Cannot close file %s.\n",rzFileName) ; 
exit(2); /* unable to start operation */ 
Yprite 
nFilest+; 
} /* while */ 
printf(*%d help text files created.\n*,nFiles); 
exit(0); 
} /* main() */ 


44 Listing 8: 
Fortsetzung 


«Listing 9: 

Das DOS-Programm 
SPLIT zerteilt 
HELP.TXT in ein- 
zelne Dateien, die 
vom Ressourcen- 
Compiler eingelesen 
werden. 
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Bei PC-Software setzen wir weltweit den Standard. Microsoft-Produkte stehen 
für Leistung und Benutzerfreundlichkeit. Einige Beispiele: die Betriebssysteme 
MS-DOS und MS OS/2, die Textverarbeitung MICROSOFT WORD oder die 
WINDOWS-Applikation MICROSOFT EXCEL. 

Für unsere Hauptverwaltung in München suchen wir 


SOFTWARE-TRAINER/IN 


Im Rahmen unseres MICROSOFT-Instituts sind Sie verantwortlich für Schulungen 
über unsere System-Software für Großkunden und renommierte Hardware-Her- 
steller. Dies umfaßt ein Spektrum von der Vorbereitung der Seminarunterlagen 


über die Präsentation bis hin zur persönlichen Beratung. 


Wir sind ein modernes 
und innovatives Unter- 
nehmen. Als deutsche 
Tochter des Weltmarkt- 
führers fürhochwertige 
System- und Applika- 
tionssoftware im PC- 
Bereich verzeichnen 
wir jährlich überdurch- 
schnittliche Zuwachs- 
raten. Unser Arbeitsstil 
ist kooperativ und lei- 
stungsorientiert. 
Kreativität und Einsatz- 
freude eröffnen unse- 
ren Mitarbeitern viel- 
seitige Entwicklungs- 
möglichkeiten und si- 
chern den gemeinsa- 
men Erfolg. 


Nach einem DV-orientierten Hochschulstudium haben Sie Ihr 
pädagogisches Geschick bereits in der Praxis unter Beweis gestellt. 
Sie haben gute Kenntnisse in einer höheren Programmiersprache, 
idealerweise in „C“. 


SOFTWARE-SPEZIALIST/IN 


FÜR MICROSOFT-WINDOWS UND 
MICROSOFT PRESENTATION MANAGER 


Sie beraten und unterstützen Software-Entwickler, die unter Micro- 
soft-Windows oder Presentation Manager arbeiten. Dies umfaßt 
neben der direkten Beratung auch Projektarbeiten bei Software- 
Entwicklern vor Ort. Außerdem organisieren Sie „Entwicklertreffs” 
und wirken bei Messen mit. 

Nach Abschluß Ihres Informatikstudiums haben Sie in den letzten 
3 bis 4 Jahren Berufserfahrung im Bereich Software-Entwicklung 
für graphische Systeme gesammelt. Sie verfügen über profunde 
Kenntnisse in „C” und idealerweise auch in Assembler. 


Für beide Positionen sind sowohl Anwendererfahrungen mit 
MS-DOS als auch gute Englischkenntnisse Voraussetzung. Außer- 


dem arbeiten Sie gern selbständig und trotzdem teamorientiert. 

Wenn Sie in einer dieser Positionen die konsequente Fortsetzung Ihrer Karriere 
sehen, schicken Sie bitte Ihre aussagefähigen Bewerbungsunterlagen mit Angabe 
der Gehaltsvorstellung an: 


Microsoft GmbH, Personalabteilung, 
Edisonstraße 1 rn u a: 
8044 Unterschleißheim un 


ZUKUNFT DER SOFTWARE 


QUICKBASIC 


MICROSOFT 


MICROSOFT 
WINDOWS 


MS 05/2 


Ein Interview mit Ethan Winer: 


Basic als 
professionelle 
Programmier- 
sprache 


Für die meisten PC-Programmierer 
sind C und der Makro-Assembler 
(MASM) die Sprachen der Wahl. 
Gelegentlich hört man von einem 
Programmierer, der Basic verwen- 
det. Im allgemeinen jedoch denken 
professionelle Programmierer, daß 
Basic eine Spielzeugsprache ist — 
nett zum Lernen, aber kaum etwas 
für ernsthafte Programmentwick- 
lung. Diese Einschätzung beginnt 
sich zu ändern. 


T atsächlich ist Basic im letzten Jahr deutlich 
erwachsener geworden. Die Benutzerober- 
fläche von Microsoft QuickBasic bietet eine lei- 
stungsfähige Arbeitsumgebung für Anfänger und 
Fortgeschrittene, und mit dem Microsoft Basic- 
Compiler Version 6 hat die Sprache inzwischen 
alle professionellen Features, die ein Program- 
mierer braucht. 

Einer von denen, die glauben, daß Basic im- 
stande ist, die Ansprüche professioneller Pro- 
grammierer zu erfüllen, ist Ethan Winer, Gründer 
von Crescent Software — einer auf Software-Ent- 
wicklung mit Basic spezialisierten Firma — und 
Entwickler von QuickPak Professional, einer 
Funktionsbibliothek speziell für Basic. Daneben 
hat Winer zahlreiche Basic-Artikel in vielen 
Fachzeitschriften geschrieben. 


! 


Leon 


Vor kurzem sprachen wir mit Winer und er er- 
zählte uns, warum er sich für Basic entschieden 
hat, warum er QuickPak Professional entwik- 
kelte, und er gab uns dabei einige Einblicke in 
technische Aspekte der Basic-Programmierung. 


Warum haben Sie und Crescent Software sich für 
Basic als Programmiersprache entschieden? 

Anders als C oder Pascal enthielt Microsoft 
Basic immer eine Fülle eingebauter Kommandos 
und Funktionen. Man kann damit anspruchsvolle 
Grafiken auf einer Vielzahl von Monitoren erzeu- 
gen, Dateien und Geräte öffnen und bearbeiten, 
Musik machen und den Speicher sowie die 
Hardware-Ports direkt ansprechen. Die Version 4 
von Microsoft QuickBasic und der Basic 6.0- 
Compiler haben weitere Befehle und Funktionen 
hinzugefügt. 

Basic war immer die am einfachsten einzuset- 
zende von allen höheren Programmiersprachen, 
und die jüngste Version ist ebenso mächtig und 
leistungsfähig wie C oder Pascal. Darüber hinaus 
hat Microsoft klar gesagt, daß es beide Compiler 
weiterentwickeln wird. 


Mit Basic stehen dem 
Programmierer 
umfangreiche Mög- 
lichkeiten zur 
Verfügung. 
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Auch Pull-Down- 
Menüs und mehr- 
fache Fenster sind 
mit Basic möglich. 
Man beachte die 
Scroll-Balken an der 
Seite des Editor- 
fensters. 


Basic 


Microsoft 
System Journal 


Sept./Okt. 1989 


60 


Welche der Features, die Basic zu einer professio- 
nellen Sprache machen, finden sie besonders nütz- 
lich? 

Der entscheidende Vorteil von Basic ist, daß es 
äußerst einfach zu lernen und einzusetzen ist; 
die Befehle und Funktionen haben sprechende 
Namen und ihr Zweck ist normalerweise offen- 
sichtlich. Anders als bei C oder Assembler ist es 
so gut wie unmöglich, versehentlich das Be- 
triebssystem oder den Speicher zu überschreiben, 
ohne daß dadurch die Kontrolle des Programms 
über die Systemressourcen eingeschränkt wür- 
den. PEEK und POKE beispielsweise erlauben es, 
jede Speicheradresse auszulesen oder zu be- 
schreiben, und INP und OUT greifen direkt auf 
die Hardware-Ports zu. 

Ein weiterer wesentlicher Vorteil von Basic be- 
steht darin, daß es Typumwandlungen automa- 
tisch erledigt. Das heißt, man kann jederzeit eine 
Integer-Zahl mit einer Double-Precision-Variable 
multiplizieren, und Basic erledigt die Umrech- 
nung automatisch. Die Stringbearbeitung ist 
ebenso mächtig; es gibt Funktionen, die Zeichen 
an jede Stelle schreiben oder von jeder Stelle 
holen. Ein weiteres mächtiges Feature ist die 
Grafik. Basic hat eingebaute Funktionen zum 
Zeichnen von Kreisen, Rechtecken, gefüllten 
Rechtecken usw. auf alle gängigen Monitortypen. 


Warum hat sich Crescent Software auf die Ent- 
wicklung einer Bibliothek von Programmiertools 
für Basic konzentriert? 

Bei den Programmiersprachen gab es in den 
letzten paar Jahren zweifellos gewaltige Fort- 
schritte. Eine Sprache aber kann noch so voll- 
ständig sein und noch so gut konzipiert, die Pro- 
grammierer werden immer meinen, daß sie die- 
ses und jenes noch brauchen. Traditionell füllen 
Bibliotheken — oder Toolboxen - von unabhängi- 
gen Herstellern diese Lücke. Eine Sprache wie C 
braucht wegen ihrer Beschränktheit die Unter- 
stützung externer Bibliotheken. »Reines« C kann 


beispielsweise weder den Bildschirm löschen 
noch den Cursor positionieren, so daß C-Pro- 
grammierer Toolbox-Routinen verwenden müs- 
sen. Meist glauben sie, das müsse so sein. Auch 
Pascal hat seine spezifischen Einschränkungen 
und mittlerweile sind Toolboxen für diese Spra- 
che ebenso alltäglich. 

Der vielleicht wichtigste Grund, eine externe 
Bibliothek zu verwenden, ist die Reduzierung des 
Entwicklungsaufwands für ein Programm. Natür- 
lich kann ein erfahrener Programmierer ein Pull- 
Down-Menüsystem oder einen voll ausgebauten 
Editor samt Mausunterstützung entwickeln, aber 
das kostet enorm viel Zeit, Zeit die man besser in 
den Rest des Programms investiert. Dazu sind die 
Anwender an hübsche Bildschirmausgaben ge- 
wöhnt, an Pop-Up-Windows und was sonst noch 
zu einer ausgefeilten Benutzeroberfläche gehört. 
Eine gute Toolbox liefert dafür Lösungen »von 
der Stange« und verbessert und erweitert gleich- 
zeitig die Programmiersprache. 


Hat sich die Bibliothek einfach aus einer Samm- 
lung von Utilities ergeben, die Sie im Laufe der Zeit 
aufgebaut haben, oder haben Sie sich eigens daran 
gemacht, sie zu schreiben? 

Ein Sortiment von Tools zu entwerfen erfor- 
dert wesentlich mehr Aufwand als, sagen wir, 
eine Schnittstelle zu den verschiedenen DOS- 
und BIOS-Funktionen zu schreiben. Oft fangen 
wir an, ein Programm zu entwerfen und entdek- 
ken als erstes, daß wir dazu eine oder mehrere 
spezielle Routinen brauchen. Häufig führte unser 
eigener Bedarf zur Entwicklung von Funktionen 
oder Unterprogrammen, die sich dann auch in 
einem weiteren Rahmen als nützlich erwiesen. 

Ein Beispiel sind die Funktionen, die das Mini- 
mum und das Maximum zweier Werte liefern. 
Sie werden in vielen Programmen von QuickPak 
Professional häufig benutzt und vermeiden eine 
Menge von IF/THEN-Anweisungen. Die Minlnt- 
Assembler-Funktion liefert das Minimum zweier 
Integer-Variablen und erspart Sequenzen wie 
IF X > MaxAllowed THEN 
Value = MaxAllowed 
ELSE 
Value = X 
END IF 

Das gleiche erledigt jetzt eine Anweisung: 
Value = MinInt (X, MaxAllowed) 

Zur Unterstützung bei der Entwicklung unse- 
res Editors QEdit haben wir eine Menge weiterer 
Funktionen geschaffen, die ebenfalls zu sinn- 
vollen Ergänzungen für das Paket wurden. 

Als wir QuickPak Professional konzipierten, 
setzten wir uns mehrere sehr klare Ziele. Wir 
wollten fertige Lösungen für allgemeine Pro- 
grammierprobleme anbieten. Sie lassen sich in 
zwei Klassen unterteilen: Routinen, die für die 
meisten Programmierer zu schwierig sind, um sie 
selbst zu schreiben, und Operationen, die mit 
Basic alleine nicht möglich sind. 


Ein Beispiel für die erste Klasse sind As- 
sembler-Routinen, etwa um ein Array schnell zu 
durchsuchen oder zu sortieren. Andere schwie- 
rige Sachen wären ein Texteditor, ein Spread- 
sheet oder eine Stoppuhr mit Mikrosekunden- 
Auflösung. 

Die zweite Kategorie besteht aus DOS- und 
BIOS-Interrupts, die Basic nicht so ohne weiteres 
ansprechen kann. Man braucht sie, um die 
Dateien auf der Platte aufzulisten, ihr Datum und 
ihre Erstellungszeit zu ändern oder um ein Plat- 
tenlabel zu lesen oder zu schreiben. 

Zweitens wollten wir, daß diese Funktionen 
sehr einfach einzusetzen sind. Beispielsweise gibt 
es von allen Routinen, die Strings durchsuchen 
und bearbeiten, eine Version, die Groß- und 
Kleinschreibung unterscheidet und eine, die das 
nicht tut. Wichtig war auch, die Zahl der Über- 
gabeparameter auf ein absolutes Minimum zu 
beschränken, und die Routinen möglichst als 
Funktionen zu implementieren. Funktionen sind, 
anders als Unterprogramme, die natürlichste Art, 
Basic zu erweitern. 

Drittens sind in einigen Fällen die Fehler- 
behandlungsmöglichkeiten von Basic nicht aus- 
reichend. In C oder Pascal ist es möglich, eine 
Datei zu öffnen und dann nachzuprüfen, ob ein 
Fehler aufgetreten ist. Basic dagegen verlangt 
eine spezielle vorab definierte Fehlerroutine. 
Wenn ein Fehler auftritt, landet man in der Feh- 
lerroutine — oft ohne daß man eine Ahnung hat, 
wie oder woher man dorthin gekommen ist. Hier 
sind Möglichkeiten, Laufwerk oder Drucker zu 
überprüfen, oder die Fehlerroutine von Basic 
ganz zu umgehen, nützliche Ergänzungen. 


So wie der Sourcecode und die mitgelieferten Tuto- 
rials aussehen, könnte man meinen, daß Sie Basic 
lehren wollen. 

Sicher. Oft brauchen Programmierer weniger 
neue Sprachfeatures als vielmehr ein Verständnis 
dafür, wie man die bereits vorhandenen Features 
nutzt. Das absolut nützlichste Tool eines Pro- 
grammierers ist Wissen. 

Jeder erfahrene Programmierer wird Ihnen be- 
stätigen, daß der beste Weg zum Könner darin 
besteht, die Programme anderer zu studieren. 
Tatsächlich sind viele Programmierer Autodidak- 
ten, die ausschließlich aus Büchern und Zeit- 
schriftenartikeln lernen. Wenn man das Pro- 
gramm eines anderen nimmt, den Sourcecode 
studiert und eventuell verändert, entsteht ein viel 
tieferes Verständnis. 

Wir wollen, daß die Leute verstehen, wie diese 
Routinen arbeiten, und daß sie davon lernen 
können. Das bedeutet nicht nur, daß man sämt- 
lichen Basic- und Assemblercode verfügbar 
macht, sondern auch diverse Tutorials schreiben 
muß, die die dahinterstehenden Konzepte erklä- 
ren. 

Die Handbücher von QuickBasic 4 sind, so 


weit sie gehen, ausgezeichnet, aber zu einer gan- 
zen Anzahl wichtiger Punkte sagen sie gar nichts, 
beispielsweise zur Übergabe von TYPE-Variablen 
und Arrays an Unterprogramme und Funktionen. 
Die Beispiele, in denen TYPE-Parameter verwen- 
det werden, kaschieren das Problem, indem sie 
das Array als SHARED deklarieren. Ebenso steht 
im Handbuch kein Wort zum Sichern und Laden 
von Arrays sowie EGA-Bildschirmdumps auf und 
von der Platte. 

Programmierer, die ihr Basic verbessern wol- 
len, müssen diese Konzepte verstehen. QuickPak 
Professional enthält viele solcher Informationen, 
zusammen mit Tutorials zu den Dateizugriffen 
oder zum Unterbringen von Strings und Zahlen 
im Codesegment des Programms, und einen Ver- 
gleich der verschiedenen Arten des Prozedur- 
designs. 


Eines der angenehmen Dinge bei Basic ist, daß es 
den Programmierer davon befreit, jede Einzelheit 
über das Betriebssystem wissen zu müssen. Das 
führt allerdings auch zu gewissen Beschränkungen. 
Können Sie einige Beschränkungen nennen, die Sie 
überwunden haben ohne die Sprache dadurch 
komplizierter zu machen? 

Basic hat viele eingebaute Kommandos, aber 
es fehlen Möglichkeiten zum Ansprechen der 
DOS- und BIOS-Interrupts. QuickBasic 2 brachte 
so etwas mit CALL INTERRUPT, allerdings war es 
ein Zusatz, der nur über ein zugebundenes Ob- 
jekt-Modul zur Verfügung stand. Dazu ist CALL 
INTERRUPT umständlich einzusetzen und man 
muß über die DOS-Funktionen Bescheid wissen, 
was bei vielen Basic-Programmierern nicht der 
Fall ist. 

Statt nun einfach nur einen etwas verbesserten 
Ersatz für CALL INTERRUPT bereitzustellen, gin- 
gen wir davon aus, daß ein Basic-Programmierer 
auf keinen Fall wissen muß, wie die DOS- und 
BIOS-Funktionen angesprochen werden. 

Lassen Sie mich ein Beispiel geben. Jede DOS- 
Funktion, die einen Dateinamen entgegennimmt, 
erwartet diesen Namen im ASCIIZ-Format, so 
wie Strings in C abgelegt werden. In Basic jedoch 
haben Strings kein Nullbyte als Endemarkierung. 
Statt dessen gibt es einen Stringdeskriptor für 
jeden String oder jedes Stringarray-Element. Ein 
Stringdeskriptor ist eine 4-Byte-Tabelle, die die 
Länge und Adresse des Strings enthält. 

Um CALL INTERRUPT zu benutzen, muß der 
Basic-Programmierer jedes Mal, wenn er einen 
Dateinamen an eine DOS-Funktion übergeben 
will, das Nullbyte selbst hinzufügen. Weil ein- 
fache Anwendung für uns höchste Priorität hatte, 
entschieden wir uns dafür, ihn den Dateinamen 
in ein Zwischenfeld kopieren zu lassen, und die 
Routine fügt das abschließende Nullbyte an, be- 
vor sie DOS aufruft. 

Eine wichtige DOS-Funktion, die von den mei- 
sten Programmen benötigt wird, ist die Möglich- 
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keit, eine Liste der Dateien auf der Platte zu be- 
kommen. Keine Anwendung, die etwas taugt, 
wird den Anwender zwingen, die Namen der zu 
ladenden Dateien im Kopf zu haben. Statt dessen 
sollte das Programm alle vorhanden Dateien auf- 
listen und irgendeine Methode bieten, eine 
davon auszuwählen. 

In DOS gibt es keine Möglichkeit, mit einer 
einzigen Operation eine vollständige Liste der 
Dateinamen zu bekommen. Sogar wenn es sie 
gäbe, müßte das Basic-Programm vorher die An- 
zahl der Namen wissen, damit es ausreichend 
Speicher dafür reservieren kann. Unsere Lösung 
besteht darin, daß wir eine Funktion schrieben, 
die die Zahl der Dateinamen zurückgibt, die 
einem gegebenen Suchkriterium genügen. So- 
bald diese bekannt ist, kann ein passendes 
String-Array reserviert werden, und eine zweites 
Unterprogramm holt dann sämtliche Namen auf 
einmal. 


Damit sind wir an einem interessanten Punkt. In 
Microsoft Basic gibt es zwei Arten von Unterpro- 


grammen: Unterprogramme, die per CALL, und 
Funktionen, die über einen Basic-Ausdruck aufge- 
rufen werden. Sie scheinen Funktionen zu bevorzu- 
gen. 

Funktionen sind wirklich praktisch und ein 
echter Gewinn. Man kann eine Basic-Funktion in 
Basic oder in Assembler schreiben. Im Mixed- 
Language Programming Guide für den Macro As- 
sembler (MASM) Version 5 steht, wie man As- 
sembler-Funktionen für QuickBasic implemen- 
tiert. 

Ein wesentlicher Vorteil von Funktionen ist die 
Eliminierung eines Übergabeparameters. Wenn 
die Routine, die die Zahl der gefundenen Datei- 
namen liefert, eine Prozedur wäre, müßte sie 
folgendermaßen aufgerufen werden: 

CALL FCount ("*.*", Count) 
PRINT Count; " Dateien wurden gefunden" 

Dieselbe Routine als Funktion ist einfacher an- 
zuwenden und zu verstehen: 

PRINT FCount ("*:*");_ 
" Dateien wurden gefunden" 

Das Ergebnis einer Basic-Funktion kann direkt 
in einer PRINT-Anweisung benutzt werden, oder, 
wie beim Reservieren der erforderlichen String- 
elemente, als Teil des DIM-Kommandos: 

DIM Array$ (FCount ("*.*")) 

Funktionen wie diese sind der natürlichste 
Weg, die Sprache Basic zu erweitern, und weil 
sie einen Parameter weniger benötigen, ist eine 
Funktion auch schneller als eine entsprechende 
Prozedur. 

Parameter werden in allen Microsoft-Sprachen 
auf dem Stack übergeben, und es ist kein Ge- 
heimnis, daß Stackoperationen ziemlich langsam 
sein können. Deshalb sind Funktionen besonders 
gut, wenn sie ohne Parameter eingesetzt werden. 
Wir haben beispielsweise eine Anzahl Funktio- 
nen, die den Status verschiedener Tastaturein- 
stellungen zurückgeben. Die übliche Methode, 
den Status, sagen wir, der Alt-Taste festzustellen, 
geschieht mit Hilfe der DEF SEG-, PEEK- und 
AND-Kommandos von Basic: 

DEF SEG = 0 
AltKey = PEEK (&H417) AND 8 
IF AltKey THEN PRINT_ 
"Die »Alt«-Taste ist gedrückt" 

Mit einer speziellen Funktion kann man diesen 
ganzen Code durch eine einzige Anweisung er- 
setzen: 

IF AltKey THEN PRINT_ 
"Die »Alt«-Taste ist gedrückt" 

Ohne Parameterübergabe braucht man zur 
Implementierung einer solchen Funktion nur 
fünf Assembler-Anweisungen (Listing 1). 


Wieder taucht Assembler auf. Es scheint, als wäre 
es sogar für Basic-Programmierer nötig, Assembler 
zu können. Was glauben Sie? 

Viele Hochsprachen-Programmierer würden 
gerne Assembler lernen, schrecken aber davor 
zurück, weil sie fürchten, daß das langwierig und 


mühsam ist. Doch Assembler zu lernen, ist gar 
nicht so mühsam, und schon ein bißchen darüber 
zu wissen, ist für einen Basic-Programmierer 
nützlich. Um eine Assembler-Routine anzuwen- 
den, braucht man natürlich keine Assembler- 
Kenntnisse. 


Muß man bei Assembler-Funktionen etwas beson- 
deres beachten? 

Was einem als erstes einfällt, ist, daß eine As- 
semblerfunktion, bevor sie in Microsoft Basic 
verwendet werden kann, in dem Programm, das 
sie verwenden will, deklariert werden muß. Daß 
man Prozeduren deklarieren muß, ist neu in 
Basic, aber in diesem Fall durchaus sinnvoll. An- 
dernfalls würde QuickBasic in dem Beispiel mit 
der Alt-Taste annehmen, daß »AltKey« einfach 
eine Integervariable ist. Wenn man sie vorher 
deklariert, weiß QuickBasic, daß »AltKey« eine 
aufzurufende Funktion ist und daß der Wert im 
AX-Register ihr Ergebnis darstellt. 


Und dann macht Assembler gelegentlich die Sache 
auch etwas schneller. 

Das ist ein ebenso wichtiger Grund, Assembler 
einzusetzen. Wir wollten diejenigen Operationen 
beschleunigen, die in allen Hochsprachen typi- 
scherweise sehr langsam sind. Assembler ist nun 
einmal der Schlüssel für eine gute Performance, 
und etwa zwei Drittel aller Routinen in QuickPak 
Professional sind in Assembler geschrieben. 

Die meisten Compiler für DOS wickeln Bild- 
schirmausgaben über das Betriebssystem ab, um 
mit möglichst vielen Rechnern kompatibel zu 
sein. Ob über DOS oder das BIOS, es dauert zu 
lange. QuickBasic 4 schafft hier etwas Abhilfe, 
indem es direkt in den Videospeicher schreibt, 
aber auch da gibt es noch viel zu verbessern. 
Jedes Zeichen wird darauf geprüft, ob es ein spe- 
zielles Kontrollzeichen ist, und bei jedem Zeichen 
geht nochmals Zeit für die Prüfung verloren, ob 
der Bildschirm gescrollt werden muß. Wir haben 
einige sehr schnelle Routinen für die Ausgabe auf 
mehrere Video-Seiten geschrieben und für eine 
Textausgabe, die die aktuellen Bildschirmfarben 
nicht zerstört. 

Besonders nützlich ist eine Routine, die einen 
Teil eines String-Arrays ausgibt, indem es ihn 
direkt in einen angegebenen Bildschirmbereich 
schreibt. Das vereinfacht die Entwicklung bei- 
spielsweise einer Browse-Funktion, mit der man 
am Bildschirm durch ein ganzes Array scrollen 
kann. Auch hier war unser Ziel, daß diese Routi- 
nen so viel wie möglich selbst erledigen und dem 
Programmierer unnötige Arbeit ersparen. 


Assemblerroutinen können dem Basic-Programmie- 
rer auch eine wesentlich schnellere Array-Verarbei- 
tung bescheren. 

Genau das ist es, wo Assembler Basic wirklich 
ein wesentliches Stück weiterbringt, bei der Ar- 
rayverarbeitung. Wir stellen beispielsweise Funk- 


Kor AX,AX ;look at BIOS data in low memory 


B 
Mov AL,ES:[417h] ;get the keyboard status byte 
And AL,00001000b ;clear all but the Alt Key bit 
Ret ‚return to BASIC, AX holds result 


tionen, die den größten oder kleinsten Wert lie- 
fern, für jeden Arraytyp in Microsoft Basic zur 
Verfügung. Eine spezielle Assemblerroutine ist 
gewöhnlich sechs bis sieben Mal schneller als 
eine entsprechende Basic-Funktion. 

Eine noch größere Verbesserung läßt sich 
beim Speichern eines ganzen Stringarrays auf die 
Platte und beim späteren Wiedereinlesen errei- 
chen. Eine der langsamsten Basic-Operation ist 
das Einlesen von Daten aus einer sequentiellen 
Datei. Dabei muß jedes einzelne Byte geprüft 
werden, ob es ein Carriage Return ist, das ein 
Stringende markiert, oder ein CHR$(26), das das 
Dateiende anzeigt. Eine spezielle Assemblerrou- 
tine, die mit einer Operation die ganze Datei an- 
geht, spart enorm Zeit. 

Die schnellste Art, in Basic ein Zahlenarray ab- 
zuspeichern, ist BSAVE. Das erspart eine Menge 
von PRINT-Ausgaben in eine Datei. Deren 
Hauptproblem ist der Aufwand, der nötig ist, um 
die Werte vom internen PC-Format in die ent- 
sprechenden ASCII-Ziffern zu konvertieren. 
Obendrein braucht BSAVE weniger Plattenplatz. 

Integerzahlen belegen im Hauptspeicher nur 
zwei Bytes. In der ASCII-Darstellung dagegen 
brauchen sie bis zu fünf Bytes, und bis zu sechs, 
wenn die Zahl negativ ist. Zusätzlich ist für jede 
Zahl in der Datei noch ein Carriage Return plus 
Line Feed oder ein trennendes Komma nötig. 
BSAVE dagegen macht einen »Schnappschuß« 
von einem beliebigen Bereich im Speicher und 
schickt ihn in einem Zug auf die Platte. Der kom- 
plementäre Befehl ist BLOAD, der eine zuvor ge- 
schriebene BSAVE-Datei wieder einliest. 


Was ist mit Stringarrys? 

Anders als Zahlenarrays erstrecken sich 
Stringarrays in Basic nicht über zusammenhän- 
gende Speicheradressen. Statt dessen liegen die 
Deskriptoren-Tabellen hintereinander, und die 
tatsächlichen Daten können irgendwo im aktu- 
ellen Segment sein. Deshalb müssen die Daten 
aller Elemente in einem einzigen Block gesam- 
melt werden, ehe BSAVE auf einen Stringarray 
angewendet werden kann. Zwei spezielle Routi- 
nen bearbeiten sämtliche Stringelemente und 
kopieren sie in ein Integerarray. Eine zusätzliche 
Routine erlaubt, wenn nötig, ein einzelnes 
Stringelement einzulesen. 

Zahlenarrays sind bei QuickBasic nicht auf das 
aktuelle Segment begrenzt. Allein schon ein 
Stringarray in ein anderes Segment kopieren zu 
können ist eine nützliche Sache. Und wenn der 
Platz knapp wird, kann man die Arrays leicht auf 
Platte auslagern und so Platz gewinnen. 


Listing 1: Ein Bei- 
spiel für eine Basic- 
Funktion, die mit 
MASM geschrieben 
wurde. 
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DEFINT A-Z 
DECLARE SUB Wordkrap (X$, Wide) 


cLS 


A$ = "BASIC strings use a descriptor table ot tell each string's" 
B$ = "length and memory location. At first glance, it seems that" 
C$ = "any two strings can be exchanged by just swapping their" 

D$ = "descriptor tables. Once we could exchange strings for* 

E$ = *sorting purposes, it was a simple matter to insert or* 

F$ = "delete elements in an array. On a standard IBM PC, inserting* 
6$ = "a single string at the beginning of a 2000 element array" 

H$ = "takes more thatn two seconds using Microsoft QuickBASIC.“ 


W=AS+BE+LCHrDs HE HS HC + HH 
PRINT W$ 

PRINT 

Wide = 60 
WordWrap W$, Wide 


"the maximum width of the display 


SUB WordWrap (X$, Widex) 


Length% = LEN(X$) 
Pointer% = 1 


‘remember the length 
"start at the beginning of the string 


*scan a block of sixty characters backwards, looking for a blank 
'stop at the first blank, or if we reached the end of the string 
00 
FOR X% = Pointer% + Widek TO Pointer% STEP -1 
IF MIDO$(X$, X%, 1) = * " OR X% = Length% + 1 THEN 
*LOCATE „ LeftMargin "optional to tab in the left edge 
PRINT MIO$(X$, Pointerx, X% — Pointer%); 
"LPRINT [TAB(LeftMargin)]; MID$(X$, Pointer*, X% — Pointer%) 
Pointer% = X& + 1 
WHILE MID$(X$, Pointer%, 1) = * * 
Pointer% = Pointerk + 1 'swallow extra blanks to next word 
WEND 
IF POS(0) > 1 THEN PRINT *if cursor didn't wrap next line 
EXIT FOR *done with this block 
END IF 
NEXT 


LOOP WHILE Pointer% < Length% "loop until done 


END SUB 


Weil wir zusätzlich jeden String mit einem 
Carriage Return/Line Feed abschließen, kann die 
Datei von jeder Anwendung direkt gelesen wer- 
den. 


Sie haben den Basic-Benutzern zwei »neue« Daten- 
typen gegeben. Was sind »sehr lange Integer« und 
»Bit Arrays«? 

Aus der Arbeit an QuickPak Professional erga- 
ben sich mehrere interessante Konzepte und 
Routinen, unter anderem zwei »neue« Daten- 
typen. 

Ein wichtiges und lange überfälliges Feature 
von QuickBasic 4 ist die Unterstützung langer (4 
Byte) Integers. Es gibt Fälle, in denen lange Inte- 
gers entschieden vorteilhafter sind als Gleitkom- 
mazahlen, weil man sie sehr schnell und ohne 
Rundungsfehler berarbeiten kann. Buchhalter 
mögen das. Wenn man sie für Pfennige nimmt, 
ist ihr Wertebereich von +/- DM 21.474.836,47 
im allgemeinen ausreichend — außer für ernst- 
hafte Finanzgeschäfte. 

Als Lösung haben wir eine Reihe von Routinen 
entworfen, um, wie wir es nennen, sehr lange 
Integer zu addieren, subtrahieren, multiplizieren 
und dividieren. Diese Variablen sind acht Byte 
lang und erlauben die Verarbeitung extrem 
großer Zahlen ohne Rundungsfehler. Man defi- 
niert eine »Very Long«-Variable, indem man sie 
einer gewöhnlichen »Double Precision«-Variable 
als Alias-Namen zuweist und Basic merkt nicht 
das geringste davon. 


Andererseits haben wir zwei Routinen für die 
Behandlung von Bit-Arrays erstellt. Die kleinste 
Variable, die Basic bietet, ist eine 16-Bit-Integer- 
Variable. Wenn ein Programm den Wertebereich 
von Integern braucht, ist es absolut sinnvoll, da- 
mit zu arbeiten. Aber oft braucht man nicht mehr 
als einfache Ja/Nein-Variablen und ein Integer- 
array verschwendet dann enorm viel Speicher. 
Ein Bit-Array mit 1000 Elementen belegt nur 125 
Byte, während ein gewöhnliches Integer-Array 
2000 Byte braucht. 


Sie haben auch eine Routine, mit der Basic-Pro- 
gramme gleichzeitig auf zwei Monitore schreiben 
können. Wie haben Sie das hingekriegt? 

Es ist kein Problem, eine Routine zu machen, 
die den aktiven Monitor wechselt, wobei jedes 
Umschalten zwischen den Monitoren bedeutet, 
daß der Bildschirm gelöscht wird. Weil nichts das 
Programm daran hindern kann, direkt in den 
Bildschirmspeicher eines inaktiven Monitors zu 
schreiben, konnten wir unsere Lösung elegant 
implementieren. 

Alle Video-Routinen von QuickPak Professio- 
nal stellen bei ihrem Aufruf automatisch den Typ 
des installierten Monitors fest. Das ist aus zwei 
Gründen nötig. Zum einen ist das Videosegment 
bei Farb- und Monochrom-Monitoren unter- 
schiedlich, so daß das richtige Segment bekannt 
sein muß, damit die Routine direkt in den Bild- 
schirmspeicher schreiben kann. Zum andern, und 
das ist ebenso wichtig, »schneien« CGA-Bild- 
schirme, wenn man Lesen und Schreiben nicht 
mit der Bild-Wiederholfrequenz synchronisiert. 

In der Routine, die auf jeden beliebigen Moni- 
tor schreibt, muß der Aufrufer den Monitor, auf 
den geschrieben werden soll, mit einem Code 
angeben; 1 bedeutet Monochrom, 2 ist ein CGA- 
und 3 steht für einen EGA- oder VGA-Schirm. 
Obwohl ein PC zwei Monitore gleichzeitig unter- 
stützen kann, müssen sie unterschiedlich sein — 
das heißt, sie können nicht beide ein Farb- oder 
Monochrom-Monitor sein. Deshalb braucht der 
Programmierer nur den Monitortyp anzugeben, 
der nicht der aktuelle ist. Natürlich gibt es auch 
eine Routine, die den Typ des gegenwärtig akti- 
ven Monitors liefert. 


Sie bieten auch eine Möglichkeit, Bildschirm- 
Dumps unabhängig vom Videomodus zu machen. 
Was können Sie uns dazu sagen? 

Wir wollten auch Grafik angehen. Eine 
wesentliche Einschränkung des GRAPHICS-Pro- 
gramms von DOS ist, daß es nur mit den CGA- 
Modi funktioniert. Dazu funktioniert es nur mit 
Druckern, die mit dem Epson-/IBM-Befehlssatz 
kompatibel sind. Weil Basic EGA, VGA und Her- 
cules unterstützt, war es wichtig, eine Routine 
bereitzustellen, die Grafiken aus diesen Modi 
heraus drucken läßt. 

Wir fanden, daß eine wirklich nützliche Print- 
Screen-Routine nicht nur die Steuerzeichen der 


Epson-Drucker beherrschen muß (die alle moder- 
nen Drucker emulieren können), sondern auch 
die des HP Laserjets. Und weil ein Laserjet in 
mehreren Größen drucken kann, sollte der Auf- 
rufer die gewünschte Größe angeben können. 
Dann war nur noch zu klären, was mit den Far- 
ben geschehen soll. Ein noch so beeindruckendes 
dreidimensionales Diagramm in sechzehn Farben 
ist als Hardcopy nutzlos; alles was man be- 
kommt, ist ein großer schwarzer Kreis. Die ein- 
deutig beste Lösung ist es, jede der möglichen 
Bildschirmfarben durch ein Schraffurmuster zu 
ersetzen. Was die Sache allerdings ausgespro- 
chen kompliziert macht, sind die verschiedenen 
Arten, in denen der Grafik-Bildschirmspeicher 
organisiert ist. 

Im Textmodus befinden sich aufeinanderfol- 
gende Zeichen in aufeinanderfolgenden Bytes im 
Bildschirmspeicher. In den CGA-Modi dagegen 
ist der Bildschirmspeicher mit einer Methode 
namens »Interlacing« organisiert. Bei einem sol- 
chen System ist jede zweite Zeile in einem ande- 
ren Speicherblock, und das macht die Speicher- 
zugriffe um vieles schwieriger. 

Auch Hercules arbeitet mit Interlacing, nur ist 
es da jede vierte Zeile. EGA und VGA arbeiten 
wieder nach einem anderen Prinzip, bei dem jede 
Farbe in einem eigenen Segment steht. Das er- 
schwert es, den Bildschirmspeicher zu lesen oder 
Farben in Schraffurmuster umzusetzen. 


Eine ihrer Leistungen war die Entwicklung von 
QEdit, einem in Basic geschriebenen Textpro- 
gramm. Die variabel langen Strings von Basic müs- 
sen dabei sehr nützlich gewesen sein. 

Sprachen wie C oder Pascal, die nur Strings 
mit fester Länge zulassen, erfordern viel mehr 
Programmieraufwand, um zu den gleichen Er- 
gebnissen zu kommen. Das Programm vergeudet 
entweder den größten Teil des Speichers für 
Textzeilen, die kürzer als das Maximum sind, 
oder es muß eine Pointertabelle mit den Adres- 
sen führen, an denen die einzelnen Strings im 
Speicher stehen. Immer wenn man Zeichen und 
Zeilen einfügt oder löscht, müssen die Pointer 
aktualisiert werden. 

Die Tatsache, daß Basic variabel lange Strings 
unterstützt, hat uns sehr viel Arbeit erspart. Basic 
erledigt das alles sehr schnell und automatisch, 
und der Zeilenumbruch von QEdit kommt auch 
beim besten Schnellschreiber mit. (Siehe Listing 
2 für ein Beispiel des Zeilenumbruchs mit Basic 
und Listing 3 für ein Beispiel einer Funktion zur 
Abfrage der Bildschirmfarben - Die Red.) 


Variabel lange Strings müssen dynamisch allokiert 
werden. Das dürfte einige Probleme bereitet haben. 
Mit am schwierigsten war die Entwicklung der 
Routinen zur Behandlung von Stringarrays. Dazu 
waren weitere Nachforschungen nötig. Vor allem 
brauchten wir einiges an Informationen über die 
internen Operationen von Microsoft Basic. 


DEFINT A-Z 

DECLARE SUB GetColor (FG, BG) "gets BASIC's current colors 
DECLARE SUB SplitColor (XColor, FG, BG) '.ASM - splits a color into FG 
' and BG 

*,ASM — combines F&/8G into one 
" color 


DECLARE FUNCTION OneColor% (FG, BG) 


CL5 

INPUT "Enter a foreground color value (0 to 31): *, FG 
INPUT "Enter a background color value (0 to 7) : *, BG 
COLOR FG, BG 


PRINT : PRINT "BASIC's current color settings are: "; 
GetColor FG, BG 
PRINT FG; "and"; BG 


PRINT "That combines to the single byte value of"; OneColor%(FG, BG) 
PRINT "Broken back out results in"; 

SplitColor OneColors(F&, BG), NewrG, NewBG 

PRINT NewfG; "and“; NewBG 

COLOR 7, 0 'restore defaults before ending 

‘This function obtains BASIC's current colors by first saving the 
‘character and color in the upper left corner of the screen. Next, 
'a blank space is printed there, and SCREEN is used to see what color 
'was used. Finally, the original screen contents are restored. 


SUB GetColor (FG%, 86%) STATIC 
V% = CSRLIN 
H% = POS(0) 
SaveChar% = SCREEN(1, 1) "save the current character 
SaveColor% = SCREEN(1, 1, 1) "and its color 
SplitColor Savelolor%, Savef6%, SaveB6% 


‘save the current cursor location 


LOCATE 1, 1 

PRINT ı m; CHR$(29); 
CurColor% = SCREEN(1, 1, 1) 
COLOR Savef6%, SaveB6% 
PRINT CHR$ (SaveChar%); 


‘print with BASICrs current color 
"back up the cursor to 1,1 

'read the current color 

'restore the original color at 1,1 
"and the character 


LOCATE V%, H% 
SplitColor CurColor%, FGk, B6% 


"put the cursor back where it was 
'split the color into separate 
'FG and BG 


COLOR F6%, B6% 'restore BASIC's current value for it 


END SUB 


Weil Basic Strings von nahezu jeder Länge 
zuläßt, werden sie, wie Sie schon sagten, je nach 
Bedarf dynamisch allokiert. Das macht die 
Speicherverwaltung ausgesprochen schwierig, 
und verständlicherweise betrachtet Microsoft 
viele der Einzelheiten als sein Eigentum. 

Das zeigte sich sofort, als wir versuchten, eine 
Routine zu schreiben, die ein Stringarray sortiert. 
Ich sagte bereits, daß Basic Strings über eine Be- 
schreibungstabelle verwaltet, in der die Länge 
und die Speicheradresse eines jeden Strings 
steht. Auf den ersten Blick könnte man meinen, 
daß es für das Auswechseln zweier Strings reicht, 
ihre Beschreibungstabellen auszutauschen. Die 
Tabelleneinträge sind in den QuickBasic-Hand- 
büchern gut dokumentiert, aber leider ist das 
nicht alles. 

Was nicht erwähnt wird, ist, wie die String- 
daten verknüpft sind. Es dauerte einige Tage, bis 
wir es durch Probieren herausbekamen. Als wir 
dann Strings zum Sortieren vertauschen konn- 
ten, war es nur noch eine Kleinigkeit, Elemente 
einzufügen oder zu löschen. Das Einfügen eines 
einzigen Strings am Anfang eines Arrays mit 
2000 Elementen dauert mit QuickBasic auf 
einem Standard-PC länger als zwei Sekunden. 
Eine entsprechende Assembler-Routine dagegen 
braucht nur eine Zehntelsekunde. 


Einige der Stringfunktionen von QuickPak müssen 
ähnliche Probleme bereitet haben. Aber auch hier 


Listing 3: 
GETCOLOR.BAS 
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scheinen Sie sich das Leben erleichtert zu haben, 
indem Sie daraus »Funktionen« machten. 

Stringfunktionen waren tatsächlich einer der 
anderen Problempunkte — und wieder, weil die 
Informationen fehlten. Abgesehen davon, daß sie 
einen Übergabeparameter einspart, erspart eine 
Funktion, die einen String direkt übergeben 
kann, es dem Programmierer, zuvor immer erst 
Platz für sie zu reservieren. 

Eine der Routinen in QuickPak Professional 
ermittelt das aktuelle Verzeichnis eines angege- 
benen Laufwerks. Weil ein Verzeichnisname bis 
zu 64 Zeichen lang sein kann, müßte eine solche 
Routine zuerst einen String dieser Länge allokie- 
ren. Am Ende müßten dann die überzähligen 
Zeichen von Hand entfernt werden. 

Weil DOS alle Strings, die es liefert, mit einem 
Nullbyte abschließt, muß so ein Programm mit 
Basics INSTR-Funktion dieses Byte suchen; die 
Zeichen bis dahin übernimmt es dann. 

Dir$ = SPACE$ (64) 

' 64 Byte reservieren 
Drive$ = "C" 

' Laufwerk angeben 
CALL GetDir (Drive$, Dir$) 

' GetDir versorgt Dir$ 
Zero = INSTR (Dir$, 0) 

' Nullbyte suchen 
Dir$ = LEFT$ (Dir$, Zero - 1) 

' alles vor der 0 aufheben 

Als Stringfunktion ist GetDir wesentlich ein- 
facher anzuwenden: 
Drive$ = "C" 

Dir$ = GetDir$ (Drive$) 
Dir$ = GetDir$ ("A") 

Als Funktion sucht GetDir das Nullbyte und 
liefert dann einen String mit genau der richtigen 
Länge. 


oder 


Kommen wir auf QEdit zurück. Offensichtlich 
haben Sie in QEdit die Editierkommandos von 
QuickBasic 4 emuliert. Es gibt schon so viele Edito- 
ren, warum haben Sie einen weiteren geschrieben? 

Es gibt eine Menge Editoren zu kaufen, aber 
ich weiß keinen, bei dem der Sourcecode gratis 
mitgeliefert wird, und auch keinen, der dazu ge- 
dacht ist, in andere Programme eingebaut zu 
werden. Die Leute drängen uns oft, irgendwelche 
neuen Routinen zu entwickeln, aber am meisten 
fordern sie einen Texteditor, den sie anpassen 
und in ihre eigenen Programme einbauen kön- 
nen. Natürlich stellt sich unter einem »Editor« 
jeder etwas anderes vor und jeder Programmie- 
rer hat seine eigenen Vorstellungen, wie er arbei- 
ten sollte. 

Unsere Kunden sind mit den QuickBasic-4- 
Kommandos vertraut, und so war es nahelie- 
gend, diese zu emulieren. Aber weil der Source- 
code mitgeliefert wird, ist eine Anpassung an be- 
liebige Tastenkombinationen jederzeit möglich. 
Aber die Editierkommandos festzuzlegen, war 
nur der Anfang. 


Um wirklich nützlich zu sein, muß ein Textedi- 
tor Text als einzelne Zeilen akzeptieren und auch 
als »eine Zeile pro Absatz«, wie viele Textpro- 
gramme. Dazu sollte der Benutzer den Druck- 
rand einstellen, die Fenstergröße verändern und 
den Text mit einer Maus durchlaufen lassen kön- 
nen — ohne daß das aufrufende Programm ir- 
gendetwas dazu tun müßte. Und selbstverständ- 
lich müssen die Tastatureingaben so schnell ver- 
arbeitet werden, daß sie für den Benutzer völlig 
transparent sind. QEdit hat einige wichtige Fea- 
tures wie Mausunterstützung, Blockoperationen 
und Online-Hilfe. Das vielleicht wichtigste Fea- 
ture jedoch ist die Möglichkeit, nicht benötigte 
Features zu entfernen. Wenn jemand einen Mini- 
maleditor will, nur mit Druckrand und Zeilenum- 
bruch, dann sollte der Code für die Blockope- 
rationen und die Mausunterstützung herausge- 
nommen werden können. Wir haben diese Teile 
von QEdit deshalb in separate Abschnitte gelegt, 
wo der Anwender sie leicht löschen oder aus- 
kommentieren kann. 

Ein weiteres Feature, das wir für unseren eige- 
nen Bedarf brauchten, waren Blockoperationen 
für Spalten, für Worte und für Zeilen. Die mei- 
sten Editoren arbeiten nur im Satzmodus, so daß 
beim Markieren eines Blocks nach unten immer 
die ganze Zeile mitgenommen wird. Für ein 
Textprogramm ist das meist ausreichend. Aber 
wenn man programmiert, ist es sehr praktisch, 
wenn man einen langen Abschnitt markieren und 
seine Einrückstufe in einem verändern kann. Ein 
Spaltenmodus erleichtert auch das Kopieren oder 
Verschieben von Tabellen. 


QEdit wurde offensichtlich als Pop-Up-Utility ent- 
worfen. 

Obwohl QEdit nicht als eigenständiges Text- 
programm gedacht ist, kann man ihn doch so 
benutzen. Allerdings ist er dafür konzipiert, daß 
die Anwender ihn als eine Pop-Up-Utility in ein 
Basic-Programm einbauen und so zeigen, daß 
mit Basic auch anspruchsvollere Programme ge- 
schrieben werden können. 


Welche Schwierigkeiten hatten sie dabei? 

Weil QEdit so viel kann, gibt es für ihn vier 
Hilfsbildschirme, die über F1 aufgerufen werden. 
Der Hilfstext ist im Codesegment des Programms 
untergebracht und wird von einer speziellen 
Assemblerroutine geholt. Das spart an die 2 
Kbyte Stringspeicher. Und weil die Anwender die 
Maus- und Blockoperationen entfernen können, 
wird in jedem dieser Abschnitte eine Variable 
verändert, so daß der Code für die Hilfefunktion 
weiß, welche Bildschirme gebraucht werden. 

Die gleiche Methode wie beim Speichern des 
Hilfetextes außerhalb des Stringspeichers benutz- 
ten wir für das Cut-and-Paste-Clipboard. Andern- 
falls könnte Basic, wenn ein größeres Dokument 
geladen ist, beim Einlesen des Blocks leicht der 
Speicher ausgehen. 


Damit sind wir an einem 
wichtigen Punkt. Es war schon 
schwer, eine Spalte einzulesen, 
die über mehrere Bildschirmsei- 
ten gehen kann. Sie zu löschen 
oder woanders einzufügen war 
noch schwieriger. Um zu vermei- 
den, daß der Textblock String- 
speicher wegnimmt, ist das Clip- 
board als Integerarray imple- 
mentiert. Wir hatten bereits 
einen Stringmanager geschrie- 
ben, der ein Stringarray ganz 
oder teilweise in ein Integer- 
array und zurück kopiert, aber 
das Einlesen und Einfügen einer 
Spalte erforderten zwei weitere 
spezielle Assembler-Routinen. 

Eine Routine kopiert Ele- 
mente eines Stringarrays in ein 
Integerarray, wobei sie jeweils 
an einem bestimmten Offset be- 
ginnt und nur eine bestimmte 
Anzahl Zeichen kopiert. Wenn 
eine Zeile nicht bis zum Ende 
der Spalte reicht, wird der Rest 
mit Leerzeichen aufgefüllt. Die 
zweite Routine holt die Bestand- 
teile des Strings Stück für Stück 
aus dem Integer-Array, so daß 
die Zeilenumbruch-Funktion den 
Inhalt des Clipboards wieder in 
den Text einfügen kann. 

Zusätzlich brauchten wir eine 
Routine zum Schließen eines 
zuvor gesicherten Bildschirmbe- 
reichs. Weil QEdit ein Pop-Up- 
Programm ist, sichert es den 
darunterliegenden Bildschirm 
automatisch. Wenn sich die Bild- 
schirmgröße ändert, kann das 
kompliziert werden. 


Sie mußten also Routinen zur 
Veränderung der Größe von Bild- 
schirmfenstern schreiben. Wie ar- 
beiten die? 

Der Anwender kann jederzeit 
die Ecke links oben oder rechts 
unten mit der Maus anklicken 
und verschieben. Solche Fenster 
sind natürlich nichts Neues, aber 
wir wollten, daß sich das Fenster 
wirklich ändert, anstatt nur an- 
zuzeigen, wie es nach dem Los- 
lassen des Mausknopfs aussehen 
würde. 


Bei einigen Programmen ver- 
ursacht das Verändern der Fen- 
stergröße ein starkes Flackern. 
In QEdit benutzen wir eine Rou- 
tine, die nur den Teil des Bild- 
schirms schließt, der von der 
Veränderung betroffen ist. 

Wir haben noch eine Menge 
ähnlicher Routinen für QEdit 
und ganz allgemein für Quick- 
Pak Professional geschrieben. 
Zum Beispiel eine, die schnell 
ein Stringarray durchläuft, um 
die Zeilenzahl festzustellen. Eine 
andere hält den Mauszeiger in- 
nerhalb eines bestimmten Bild- 
schirmbereichs. Eine weitere 
ermittelt den aktuellen Video- 
modus, so daß sich ein Pro- 
gramm automatisch auf 25, 43 
oder 50 Zeilen einstellen kann. 

Wie man sieht, ist eine Un- 
menge von Details nötig, um ein 
voll ausgebautes Textprogramm 
zu implementieren, gleich wel- 
che Sprache man benutzt. 
QuickBasic und der Microsoft 
Basic 6.0-Compiler sind ideal für 
alle Anwendungen, die umfang- 
reiche Stringmanipulationen er- 
fordern, ganz besonders aber 
sind sie für Textverarbeitungs- 
programme geeignet. 


Sie sind fest davon überzeugt, daß 
Basic eine »richtige« Program- 
miersprache ist? 

Ich habe volles Vertrauen zu 
Basic als einer ernsthaften An- 
wendungssprache. Sie erlaubte 
Millionen von Menschen zu pro- 
grammieren — echtes Program- 
mieren. Es ist schade, daß viele 
sonst so gut informierte Pro- 
grammierer Basic 6.0 und 
QuickBasic nur wegen des Basic- 
Interpreters von DOS für unge- 
eignet für »echte« Anwendungen 
halten. Abgesehen von ihrer 
außerordentlichen Geschwindig- 
keit bieten Microsofts Basic- 
Produkte auch Rekursion, struk- 
turierten Code, strukturierte 
Daten und viele andere Fea- 
tures, die zu einer modernen 
professionellen Sprache gehö- 
ren. 
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Kompatibel, aber besser: 


Das neue 
QuickPascal 
von Microsoft 


UNIT bigheap; 


BIGHEAP.PAS 
Bi. ons of GetMem 


PROGRAM objects; 


OBJECTS.PAS 


R-,S-} 


UNIT mouse; 


MOUSE.PAS 


Bild 1: 


QuickPascal erlaubt 


die gleichzeitige 


Bearbeitung mehre- 


rer Dateien in ver- 
schiedenen Bild- 
schirmfenstern. 
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hically d 


allow allocation of 


FreeMem 
[2] C:\QP\SAMPLES\OBJECTS.PAS 


Object demonstration program. 


Low-level mouse unit for QuickPascal 


Mit QuickPascal wird die überaus 
erfolgreiche Quick-Sprachen-Reihe 
von Microsoft um einen leistungs- 
starken Pascal-Compiler erweitert, 
der sich gleichermaßen an Anfän- 
ger wie professionelle PC- 
Programmierer wendet. Dabei ist 
QuickPascal mehr als nur ein 
simpler Compiler, vereinigt es in 
sich doch eine komplette Ent- 
wicklungsumgebung mit Editor, 
Compiler, Linker, Debugger und 
allem, was sonst noch dazugehört. 
Beeindruckend sind aber auch die 
objektorientierten Leistungs- 
merkmale des neuen Compilers, 
die im folgenden Beitrag unter die 
Lupe genommen werden. 


er Pascal sagt, der muß auch Turbo sagen, 

denn über Jahre hat dieser Compiler aus 
dem Hause Borland den Pascal-Markt unange- 
fochten beherrscht. Dies hat dazu geführt, daß 
mittlerweile Millionen von Programmen existie- 
ren, die unter diesem Compiler entwickelt wur- 
den. Niemand muß jedoch befürchten, daß die- 
ser Entwicklungsaufwand umsonst war oder er 
sich größeren Portierungsproblemen gegen- 
übersehen wird, sobald er sich für QuickPascal 
entscheidet, denn QuickPascal ist vollkommen 
»Source-kompatibel« zu Turbo Pascal, Version 
5.0. 

Auf den ersten Blick beweisen dies bereits die 
Demo-Programme von Turbo Pascal, wie etwa 
die kleine Tabellenkalkulation MCALC oder das 
Grafikdemo BGIDEMO, die ohne Veränderungen 
unter QuickPascal kompiliert und zum Laufen 
gebracht werden können. Daß QuickPascal aber 
noch einiges mehr zu bieten hat, als die Kompa- 
tibilität zu Turbo Pascal, das zeigt der folgende 
Testbericht. 


Die Benutzeroberfläche von 
QuickPascal 


Die verschiedenen Komponenten von Quick- 
Pascal — Editor, Compiler, Linker und Debugger — 
werden unter einer Benutzeroberfläche 
zusammengefaßt, die ganz den Richtlinien des 
SAA-Standards entspricht und dadurch den 
Bedienungskomfort realisiert, den dieser Stan- 
dard verspricht. Im Mittelpunkt des Interesses 
stehen dabei das Hauptmenü, über das die Arbeit 
mit Editor, Compiler und Debugger gesteuert 
werden kann, sowie der Arbeitsbereich, der den 
weitaus größten Teil des Bildschirms einnimmt. 

Hier — und bereits dies ist ein großer Vorteil 
gegenüber Turbo Pascal — kann der Anwender 
mehrere Fenster öffnen, um gleichzeitig ver- 
schiedene Quelldateien zu bearbeiten. Vor allem 
bei der Erstellung großer Programme, die sich 
aus mehreren Modulen zusammensetzen, erweist 
sich dies als sehr angenehm. Aber auch bei der 
Arbeit mit nur einer Quelldatei kann man aus 
dieser Möglichkeit Nutzen ziehen, denn dadurch 
lassen sich verschiedene Teile dieser Datei in ge- 
trennten Fenstern gleichzeitig auf dem Bild- 
schirm betrachten und editieren. 

Wer schon einmal permanent zwischen der ge- 
rade entwickelten Prozedur und dem Programm- 
kopf hin- und herspringen mußte, um die exakte 
Schreibweise globaler Variablen oder Konstanten 
nachzusehen, wird dieses Feature zu schätzen 
wissen. 

Die Lage und Größe der verschiedenen Fenster 
wird von QuickPascal übrigens nicht statisch 
vorgegeben, sondern kann vom Anwender fest- 
gelegt werden. Jederzeit können die verschie- 
denen Fenster vergrößert/verkleinert und ver- 
schoben werden. Auch ein kurzfristiges »Zoo- 
men« des Fensters auf Bildschirmgröße ist mit 


Hilfe eines einfachen Tastendrucks möglich und 
ebenso leicht kann es später wieder auf seine ur- 
sprüngliche Größe reduziert werden. 

Alle diese Funktionen können übrigens auch 
über die Maus erreicht werden, die - dem SAA- 
Standard folgend - voll in die Bedienung der Be- 
nutzeroberfläche integriert wurde. Dies gilt nicht 
nur für die Arbeit innerhalb der verschiedenen 
Fenster, sondern gleichermaßen auch für die 
Aktivierung von Befehlen über das Hauptmenü 
und die Dateneingabe in Dialogboxen. Tatsäch- 
lich vollzieht sich beispielsweise das Ver- 
größern/Verkleinern bzw. Verschieben der Fen- 
ster im Arbeitsbereich mit Hilfe der Maus sogar 
komfortabler als mit Hilfe der Tastatur, da sie 
sich für derartige Aufgaben besser eignet. 

Wie oben bereits erwähnt, können alle Befehle 
über das Hauptmenü erreicht werden, das jeder- 
zeit zur Verfügung steht. Um den Anfänger dabei 
nicht durch die Vielzahl der Befehle zu verwir- 
ren, kann der Anwender zwischen einer Anfän- 
ger- und einer Profi-Version von QuickPascal 
wählen. Zwar stehen alle Befehle auch in der 
Anfänger-Version weiterhin zur Verfügung, doch 
werden sie nicht mehr in den verschiedenen 
Menüs angezeigt und können daher auch nicht 
angewählt werden. 

Schreitet der Anfänger in seinem Lernprozeß 
fort, kann er auf die Profi-Version umschalten, 
ohne das Programm verlassen zu müssen. Den 
Zugriff auf alle QuickPascal-Befehle sichert er 
sich dabei durch den simplen Aufruf eines Be- 
fehls aus dem Optionen-Menü. 


Der Editor 


Wer von Turbo Pascal oder einer anderen Ent- 
wicklungsumgebung auf QuickPascal umsteigt, 
der wird mit der Bedienung des Editors unter 
Umständen etwas Schwierigkeiten haben, da die 
verschiedenen Editor-Befehle zum Einfügen, Lö- 
schen, Verschieben von Zeichen etc. über andere 
Tastenkombinationen aufgerufen werden, als er 
es bisher gewohnt war. 

QuickPascal zwingt dem Anwender jedoch 
nicht seine Vorstellungen über die Bedienung des 
Editors auf. Vielmehr kann der Anwender über 
das beigefügte Programm QPMKKEY eigene 
Tastaturtabellen erstellen, mit deren Hilfe er die 
über 60 Funktionen des Editors auf beliebige 
Tastenkombinationen abbilden kann. 

Und wem die Erstellung einer solchen Tabelle 
mit zu viel Arbeit verbunden ist, der kann auf 
mehrere vordefinierte Tabellen zurückgreifen, 
die im Lieferumfang von QuickPascal enthalten 
sind. 

Einen ganz besonderen Leckerbissen stellt die 
Fähigkeit des Editors dar, Ihr Pascal-Programm 
bereits während der Eingabe zu analysieren und 
es dadurch in Befehle, Ausdrücke und Kommen- 
tare zu scheiden. Die nämlich können auf 


ew Search Make Run Debug Options 


4] 


Help 


] C:\QP\SAMPLES\OBJECTS.PAS ng; 


{ Advance dogs. Jogger is bitten every time he collides 


with a dog. 


IN 

IF man.hit_check( dogs[n] ) THEN 
BEGIN 
Inc( bite count ) 


IF nt > quit_count) THEN 


BEGI 
GotoXY( 1, 1 


); 
Write( "Jogger decides to take up another sport.' ); 


Delay( 2000 ); 
Exit; 
END; 
GotofYT 1,1); 
Writeln( 'Ouch! Dog bites jogger.' ); 
Delay( 500 ); 
GotoXY( 1,1); 
Writeln( ' 
END; { 
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Wunsch automatisch in unterschiedlichen Farben 
dargestellt werden, was der Lesbarkeit des 
Listings am Bildschirm sehr zu Gute kommt. Die 
Farben der einzelnen Komponenten können Sie 
übrigens selbst bestimmen und dadurch die 
Farbkombinationen wählen, die Ihnen am ge- 
eignetsten erscheinen. 


Hilfe gibt's immer 


Ein weiteres Leistungsmerkmal von QuickPascal 
ist sein kontextsensitives Help-System, das sich 
bereits in anderen Quick-Compilern bewährt hat 
und Anfänger wie Profis gleichermaßen unter- 
stützt. Der Begriff »kontextsensitiv« weist darauf 
hin, daß QuickPascal bei der Betätigung der 
Hilfe-Taste (F1) nicht irgendeinen Hilfetext auf 
den Bildschirm bringt, sondern individuell auf 
die Situation eingeht, in der sich der Anwender 
befindet. 

Innerhalb des Hauptmenüs fördert die Betäti- 
gung dieser Taste deshalb einen Hilfstext mit 
Informationen über das jeweils aktuelle Menü zu 
Tage, genau wie ein »Hilferuf« innerhalb einer 
Dialogbox zur Anzeige von Informationen über 
die Bedeutung dieser Dialogbox und ihrer ver- 
schiedenen Felder führt. 

Darüber hinaus erlaubt das Hilfesystem von 
QuickPascal auch den Zugriff auf allgemeine 
Informationen mittels der sogenannten 
»Hyperlinks« — Verweise, die auf einen anderen 
Hilfetext zeigen und deren Anwahl zur Anzeige 
dieses Hilfetexts führt. 

Auf diese Art und Weise hat der Anwender 
jederzeit Zugriff auf allgemeine Informationen 
(über die QuickPascal-Umgebung, die Sprache 
Pascal, ASCII-Tabelle etc.) sowie einen Index, in 
dem alle verfügbaren Stichwörter in alphabeti- 
scher Reihenfolge aufgeführt sind. 

Neben diesen expliziten Hyperlinks kennt das 
Hilfesystem auch die impliziten Hyperlinks. Jedes 
Wort, das innerhalb des Help- oder Edit-Fenster 
mit Hilfe der Maus oder der Tastatur markiert 
wird, fungiert als ein solcher impliziter Hyper- 
link. Wird nach der Markierung dieses Begriffs 


Bild 2: 

Der Editor von 
QuickPascal mar- 
kiert die verschie- 
denen Bestandteile 
eines Pascal-Pro- 
gramms auf Wunsch 
mit unterschied- 
lichen Farben bzw. 
Attributen. 
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Search Make Run 


«Help on Help» 


rm mem me 
+Pascal Language +Contents> +Index? 


Data Types 


Structured 
String | Ordinal 


Boolean Integer 


SET 


Search Make Rur 
OF 


+Back+ 


17757777773 77777 
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The keyword OBJECT declares one or more data structures and the 
procedures and functions manipulating them. An object is a 
user-defined type. Procedures and functions that manipulate the 
data structures and provide an interface to them are called 
methods. 


Objects provide total isolation of data structure information. An 
application never knows how the data it uses is stored, and it 
never knows how the services an object provides are implemented. 
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<F1=Help> 


Bilder 3 und 4: 
Zwei Hilfeseiten, die 
mit Hilfe expliziter 
und impliziter 
Hyperlinks auf den 
Bildschirm geholt 
wurden. 
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die Hilfe-Taste betätigt, sucht QuickPascal nach 
einem Hilfetext, der Informationen im Zusam- 
menhang mit dem markierten Begriff enthält und 
wird — dank des Umfangs der Help-Datei — dabei 
in der Regel fündig. 

Insbesondere gilt dies auch für alle Pascal-Be- 
fehle, Operatoren und die Standard-Funktionen 
bzw. Prozeduren wie writeln, gotoxy etc., für 
die QuickPascal jeweils eine eigene Hilfeseite 
bereithält. In der wird dann analog zum Hand- 
buch die genaue Syntax dieses Befehls, seine 
Aufgabe, die zugehörige Unit etc. beschrieben 
und auch ein kleines Demo-Programm angebo- 
ten, das die Verwendung dieses Befehls im Rah- 
men eines größeren Kontexts verdeutlicht. 

Wie auch jeder andere Text innerhalb einer 
Hilfeseite, kann das Demo-Programm bzw. Teile 
daraus ohne weiteres vom Help- in das Edit-Fen- 
ster kopiert werden und Ihnen so Tipparbeit ab- 
nehmen. 

Die Bilder 3 und 4 verdeutlichen die Arbeit mit 
expliziten und impliziten Hyperlinks. Zunächst 
wurde über den Hilfe-Befehl im Hauptmenü eine 
Hilfe-Seite mit expliziten Hyperlinks auf einige 
allgemeine Themen angefordert und daraus die 
Hilfe-Seite mit Informationen über die Daten- 
typen von QuickPascal ausgewählt (Bild 3). 
Innerhalb dieser Seite wurde der Maus-Cursor 
dann auf den Begriff class bewegt und dann der 


rechte Mausknopf niedergedrückt, um Informa- 
tionen über diesen Begriff zu erhalten. Das 
Resultat sehen Sie im Bild 4. 


Geht's noch schneller? 


Diese Frage kommt unwillkürlich auf, wenn man 
die Kompilierungsgeschwindigkeit von Quick- 
Pascal betrachtet und fast hat man den Eindruck, 
QuickPascal würde jeden Pascal-Befehl einfach 
eins zu eins in einen Maschinensprache-Befehl 
übertragen, so schnell »fliegt« der Compiler 
durch den Quelltext. Dem ist natürlich nicht so, 
doch erreicht QuickPascal dank interner Opti- 
mierungen Kompilierungsgeschwindigkeiten, mit 
denen sich im Augenblick kein anderer Compiler 
— auch nicht Turbo Pascal — messen kann. 

Dabei ist QuickPascal Source-kompatibel zu 
Turbo Pascal, so daß Turbo-Pascal-Programme 
ohne Veränderungen in die QuickPascal-Umge- 
bung übernommen werden können. Erreicht 
wird dies durch Nachbildung der Turbo-Syntax, 
angefangen bei den Pascal-Befehlen bis hinunter 
zu den verschiedenen Compiler-Pragmas, mit 
deren Hilfe aus dem Quelltext heraus Einfluß auf 
die Kompilierung (Ein-/Ausschalten der Stack- 
und Typüberprüfungen etc.) genommen werden 
kann. 

Ebenfalls kompatibel zu Turbo Pascal sind 
natürlich die Units, die eine wichtige Rolle inner- 
halb der Gesamtkonzeption spielen. Sie dienen 
der Erstellung von Programmodulen, die — wie 
das Hauptprogramm - kompiliert eine Größe von 
maximal 64 Kbyte nicht überschreiten dürfen 
und zu einem Programm beliebiger Größe kom- 
biniert werden können. 

Auch dienen sie zur Aufnahme der Standard- 
Prozeduren und -Funktionen und so wird Quick- 
Pascal mit fünf.vordefinierten Quick-Units ausge- 
liefert, in denen sich alle Standard-Prozeduren 
und -Funktionen von Turbo Pascal und darüber 
hinaus sogar noch einige Prozeduren mehr fin- 
den. 

Neben Routinen zur Ein-/Ausgabe, zur Spei- 
cherverwaltung und dem Zugriff auf die zahlrei- 
chen DOS- und BIOS-Funktionen wird auch eine 
umfangreiche Grafikbibliothek angeboten, die 
mit allen bekannten Video-Standards (MDA, 
Hercules, CGA, EGA, VGA und MCGA) zusam- 
menarbeitet und geräteunabhängig konzipiert 
wurde. 

Eine interessante Erweiterung gegenüber 
Turbo Pascal stellt z.B. die Möglichkeit dar, Pro- 
gramme speziell für die Ausführung auf einem 
80286-Prozessor zu kompilieren, wodurch von 
den erweiterten Möglichkeiten dieses Prozessors 
Gebrauch gemacht werden kann, und das Pro- 
gramm schneller ausgeführt wird. Interessant 
sind aber auch andere Erweiterungen, wie z.B. 
die Einführung eines neuen Datentyps, des 
CSTRING, der eine Zeichenkette im C-Format auf- 


nimmt und wie ein Pascal-String in Verbindung 
mit allen String-Prozeduren eingesetzt werden 
kann. 


type KFZ = object 
5 { augenblickliche Position } 


Richtung : integer; { Bewegungsrichtung } 


Tempo : real; { aktuelle Geschwindigkeit } 
procedure Init( XPos, YPos : integer ); { Initialisierung ] 
procedure Beschleunige; { KFZ beschleunigt } 
procedure Bremse; { KFZ bremst } 


procedure Lenke( r : { KFZ ändert Richtung } 


end; 


integer ); 


Der Kammerjäger ist immer 
zur Hand 


Auch wenn Programme einmal nicht auf Anhieb 
so funktionieren, wie man sich das eigentlich 
vorgestellt hat (und das kommt bekanntlich öf- 
ters vor, als es einem lieb ist), läßt QuickPascal 
den Anwender nicht im Stich. Im Gegenteil, der 
integrierte Debugger unterstützt den Anwender 
bei der Fehlersuche, indem er ihm die Möglich- 
keit bietet, das Programm Befehl für Befehl aus- 
zuführen und am Bildschirm die jeweils ausge- 
führte Befehlszeile zu betrachten. 

Dadurch wird es nicht nur möglich, den Pro- 
grammverlauf bis ins kleinste Detail nachzuvoll- 
ziehen, sondern nach der Ausführung eines Be- 
fehls kann auch angehalten werden, um bei- 
spielsweise den Inhalt einer Variablen zu be- 
trachten oder zu verändern. 

Dieser Aufgabe dient das Debug-Fenster, das 
über einen Befehl im View-Menü geöffnet werden 
kann und dann neben den verschiedenen Edit- 
Fenstern auf dem Bildschirm erscheint. Es dient 
der permanenten Überwachung von Variablen- 
inhalten, wobei der Anwender dazu lediglich den 
Namen der zu betrachtenden Variablen (bzw. 
einen beliebigen Ausdruck) am Anfang einer 
noch leeren Zeile eingeben und dann die Return- 
Taste betätigen muß. 

Während er die Programmausführung verfolgt, 
wird der aktuelle Wert der Variablen immer in 
diesem Fenster angezeigt, so daß die Auswirkun- 
gen der verschiedenen Pascal-Befehle auf die 
einzelnen Variablen sofort deutlich werden. Dies 
gilt übrigens nicht nur für einfache Datentypen 
wie INTEGER, STRING, CHAR und BOOLEAN, sondern 
auch für komplexere Typen wie Zeiger, Arrays, 
Records etc. 

Soll die Programmausführung nicht Schritt für 
Schritt nachvollzogen, sondern erst mit dem Er- 
reichen einer bestimmten Programmzeile ge- 
stoppt werden, ist ebenfalls auf QuickPascal 
Verlaß; es erlaubt die Definition mehrerer Break- 
points, bei deren Erreichen die Programm- 
ausführung gestoppt und die aktuelle Pro- 
grammzeile im Edit-Fenster angezeigt wird, so 
daß man erkennen kann, welcher Breakpoint 
durchlaufen wurde. 


Darüber hinaus können Breakpoints auch mit 
einer beliebigen Bedingung in Form eines Pascal- 
Ausdrucks verknüpft werden, der ein BOOLEAN- 
Resultat im Sinne von TRUE oder FALSE liefern 
muß. Bei jedem Durchschreiten des Breakpoints 
wertet QuickPascal diese Bedingung aus und hält 
die Programmausführung erst dann an, wenn die 
Auswertung TRUE ergibt. 


Debug 


€ Optie 
QP\SAMPLES\SORTDEMO 


TextColor( menu_status ); 

TextBackground( menu back ); 

GotoXY( menu left + 21, Ord(current sort) + menu_to 
Write( ((finish_time - start_time) 7 ticks_per_sec 


IF sound on THEN 


finish_time : 1280591 
(finish _time-start time) / ticks per sec : 0.0 


44 Bild 6: 

Eine mögliche Dekla- 
ration des Objekts 
Kraftfahrzeug unter 
QuickPascal 


sort : T8170:064A,8170:0288,8170:0442,8170:036E,8170:0918,8170:0738) 4 
sort_array : ((7,8),(10,11),(8,9),(13,14), (43,14), (14,15), (15,1), (4,5), (33,4) ,# 
:9 


Ord(current_sort) + menu_top + 3 


Praktisch sind diese »konditionalen« Break- 
points z.B. in Verbindung mit FOR-Schleifen, 
wenn man die Progammausführung erst nach 
dem n-ten Durchlauf der Schleife anhalten 
möchte. Als Abbruchbedingung würde man dann 
definieren: Schleifenvariable = n 

Besonders tückische Fehler, wie etwa das feh- 
lerhafte Laden einer Variablen an einer unbe- 
kannten Programmstelle lassen sich damit aller- 
dings nicht aufdecken, doch haben sich die 
QuickPascal-Entwickler auch für eine solche 
Situation einen Trick einfallen lassen. Im Mittel- 
punkt steht dabei wiederum ein Ausdruck, der 
als Resultat TRUE oder FALSE liefern muß und 
beim Ergebnis TRUE zum Abbruch der Pro- 
grammausführung führt. 

Im Gegensatz zu einem konditionalen Break- 
point wird dieser Ausdruck jedoch nicht erst 
beim Durchlaufen des Breakpoints, sondern nach 
der Ausführung jedes Befehls ausgewertet. Zwar 
verlangsamt dies die Programmausführung ganz 
beträchtlich, doch wird das Warten belohnt, 
wenn der Debugger nach Eintritt der Bedingung 
die Programmzeile anzeigt, die die fehlerhafte 
Anweisung enthält. 


Alle reden von OOP, 
QuickPascal hat sie 


Objektorientiertes Programmieren, derzeit in 
aller Munde, muß dank QuickPascal keine theo- 
retische Angelegenheit mehr bleiben, denn in 
QuickPascal findet der Anwender die Grundkon- 
zepte objektorientierten Programmierens ver- 
wirklicht, ohne dabei auf traditionelle Strukturen 
verzichten zu müssen. 


Bild 5: 

Mit Hilfe des Debug- 
Fensters kann der 
Inhalt von Variablen 
während der Pro- 
grammausführung 
überwacht werden. 
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>» Bild 7: 

Die Definition der 
Methode Init für die 
Objektklasse KFZ. 
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procedure KFZ.Init( XPos, YPos : integer ); 


begin 
self.X := XPos; 
self.Y := YPos; 
self.Tempo := 0.0; 
self.Richtung := 1; 
end; 


{ aktuelle Position merken } 


{ KFZ bewegt sich nicht } 
{ Richtung initialisieren ) 


QuickPascal greift auf zahlreiche Ideen zurück, 
die der Däne Bjarne Stroustrup in der von ihm 
entwickelten Computersprache C++ realisiert 
hat. QuickPascal gehört damit wie C++ zu den 
sogenannten hybriden Sprachen, die im Gegen- 
satz zu den rein objektorientierten Systemen wie 
Smalltalk, Actor oder Eiffel Source-kompatibel 
zum bisherigen Stand der Software-Technik, den 
prozeduralen Sprachen, sind. OOPS-Puristen 
mögen nun anmerken, daß sich dem Program- 
mierer dadurch längst nicht alle Möglichkeiten 
objektorientierten Programmierens erschließen, 
doch ist dem entgegenzuhalten, daß die von 
QuickPascal gebotenen Möglichkeiten auf abseh- 
bare Zeit voll und ganz ausreichen und es sicher 
eine ganze Weile dauern wird, bis die hier reali- 
sierten Ideen die gesamte Programmierer-Welt 
durchdrungen haben werden. Außerdem sollte 
man nicht vergessen, daß man beim Umstieg auf 
rein objektorientierte Systeme allen bisher ent- 
wickelten Programmcode gleich dem Papierkorb 
zuführen kann, weil diese Systeme mit nichts 
bisher bekanntem vergleichbar sind. 

Was aber sind die Ideen, die OOPS von den 
Konzepten prozeduraler Sprachen abhebt? 


Im Mittelpunkt steht das 
Objekt 


Ausgangspunkt der OOP-Forschung, die bereits 
Ende der sechziger Jahre ihren Anfang nahm, 
sind einige — beinahe philosophische - Einsichten 
über das, was wir »Programmieren« nennen. 
Geht man der Natur dieser Tätigkeit auf den 
Grund, so kommt man schnell zu der Einsicht, 
daß bei der Programmierung eines Computers 
immer der Versuch unternommen wird, die 
Wechselwirkung zwischen den Teilen eines Sy- 
stems in der Welt eines Computers abzubilden. 
Und je komplexer diese Wechselwirkungen sind, 
desto abstrakter muß auch die Sprache sein, 
derer wir uns zu ihrer Beschreibung bedienen. 
Unter diesem Gesichtspunkt hat die Informatik 
in den letzten drei Jahrzehnten auf ihrem Weg 
von der Maschinen- über die Assemblersprache 
bis hin zu Basic, Pascal und C schon große Fort- 
schritte erzielt. Trotzdem gibt es Problemstellun- 
gen, die wir zwar mit unserem Denken erfassen 
und begreifen, sie aber nur schwer mit Hilfe pro- 
zeduraler Sprachen ausdrücken können. Wir 
kennen dieses Phänomen aus dem täglichen 
Leben, denn auch wir haben es manchmal 
schwer, Dinge zu verbalisieren, die wir ge- 


danklich gut erfassen können, ganz einfach, weil 
uns die »Worte« fehlen. 

Die objektorientierte Programmierung ver- 
sucht nun, unseren Diskurs mit dem Computer 
auf eine höhere Abstraktionsebene zu heben, die 
Computer-»Sprache« gleichsam mehr den Kate- 
gorien unseres Denkens anzugleichen. Man 
spricht hier auch von einem neuen »Paradigma«, 
eine neue Art, die Dinge zu sehen und in formali- 
sierte Beschreibungen umzusetzen. 

Wir - das hat uns die Wahrnehmungsphysiolo- 
gie gelehrt - erfassen unsere Umwelt als eine An- 
sammlung von Objekten, denen wir Attribute 
und Fähigkeiten zuordnen und die wir in Bezug 
zu anderen Objekten setzen. Diesem Gedanken 
folgend, stellt die objektorientierte Programmier- 
technik das Objekt und seine Beschreibung in 
den Mittelpunkt eines Programms. Wie auch 
einem Objekt seine Attribute (Größe, Farbe, 
Form, Inhalt etc.) innewohnen, so nimmt auch 
das QuickPascal-Objekt seine Attribute in Form 
von Variablen auf, deren Manipulation ihm allein 
vorbehalten bleibt. 

Da aber auch die Fähigkeiten eines Objekts 
etwas dem Objekt innewohnendes sind und ihm 
nicht etwa von außen herangetragen werden, 
schließt eine Objektdefinition auch die Fähigkei- 
ten des Objekts ein, die in Form sogenannter 
Methoden durch den Programmcode verkörpert 
werden. Die Verbindung von Daten und Pro- 
grammcode bezeichnet man als Kapselung 
(Encapsulation). Sie stellt eines der drei elemen- 
taren Prinzipien objektorientierten Programmie- 
rens dar. Die Definition des Objekts Kraftfahr- 
zeug innerhalb eines Verkehrssimulationspro- 
gramms könnte unter QuickPascal z.B. so 
aussehen wie in Bild 6. 

Wie Bild 6 zeigt, erfolgt die Deklaration eines 
Objekts grundsätzlich in Verbindung mit dem 
TYPE-Befehl durch Angabe des Schlüsselworts 
OBJECT. Darauf folgen die Attribute des Objekts 
in Form von Variablendeklarationen, ähnlich 
denen innerhalb eines RECORDS. An die Deklara- 
tion der Attribute schließen sich die Methoden- 
Deklarationen an, die den FORWARD-Deklarationen 
von Prozeduren und Funktionen gleichen. 
Tatsächlich werden die Methoden eines Objekts 
wie ganz normale Prozeduren und Funktionen 
behandelt, denen Parameter übergeben werden 
und die, im Falle einer Funktion, selbst ein 
Resultat an den Aufrufer zurückliefern können. 

Der Deklaration der Methoden folgt ihre Defi- 
nition innerhalb des Programmlistings, wobei 
dem Namen der Methode der Name des Objekts 
gefolgt von einem Punkt vorangehen muß. Die 
Initialisierungsprozedur der Objektklasse KFZ 
könnte z.B. so wie in Bild 7 aussehen. Beachten 
Sie bitte, daß der Prozedur zwar die beiden Para- 
meter XPos und YPos, nicht aber eine Information 
über das zu initialisierende Objekt übergeben 
wird. Die nämlich geht aus dem Aufruf der 
Methode hervor, wie ihn das Bild 8 zeigt. 


begin { beliebige Prozedur } 
var Auto : KFZ; { Auto ist ein Instanz der Objektklasse KFZ } 
begin 

New( Auto { Auto erzeugen } 


); 
Auto.Init( 15, 30 ); 
end; 


{ Auto initialisieren } 


In Bild 8 wird zunächst mit Hilfe des VAR-Be- 
fehls ein Objekt vom Typ KFZ definiert. Dadurch 
wird eine sogenannte »Instanz« der Objektklasse 
KFZ erzeugt. Auf Instanzen kann jedoch erst zu- 
gegriffen werden, nachdem für sie mit Hilfe der 
New-Prozedur Speicher allokiert wurde. Dies 
hängt damit zusammen, daß die VAR-Deklaratio- 
nen nicht die Instanz selber, sondern grundsätz- 
lich einen Zeiger auf die Instanz erzeugen, der 
mittels New mit der eigentlichen Instanz verbun- 
den werden muß. (Warum das so ist, wird in 
wenigen Augenblicken deutlich werden.) 

Natürlich kann auf diese Art und Weise nicht 
nur eine Instanz, sondern annähernd beliebig 
viele Instanzen erzeugt und mit Hilfe der ver- 
schiedenen Methoden der Objektklasse manipu- 
liert werden. Nur die Grenze des Speichers 
schränkt die Anzahl der gleichzeitig existieren- 
den Instanzen ein, doch wird für jede Instanz nur 
der Speicher für die Objektvariablen (und einige 
zusätzliche Verwaltungs-Bytes) benötigt, da die 
Methoden nur einmal kodiert und dann von allen 
Instanzen einer Objektklasse gemeinsam genutzt 
werden. 

Nachdem eine Instanz mittels New erzeugt 
wurde, kann sie mit Hilfe der Methoden der Ob- 
jektklasse, zu der sie gehört, manipuliert werden. 
Um eine solche Methode aufzurufen, muß 
zunächst der Name der Instanz, dann ein Punkt 
und dann der Name der Methode angegeben 
werden. Dahinter können, wie bei einem norma- 
len Prozedur- oder Funktionsaufruf, die zu über- 
gebenen Argumente in Klammern folgen. 

Der Terminus »Aufruf« trifft die Dinge dabei 
aber nur aus der Sicht des prozeduralen Para- 
digmas. Ein OOPS-Programmierer würde eine 
Anweisung wie 


Auto.Init( 15, 30 ); { Auto initialisieren } 
wohl eher als Auftrag bezeichnen und sie wie 
folgt kommentieren: 

»Sende an das Objekt Auto die Nachricht, daß 
es sich mit den Parametern 15 und 30 initialisie- 
ren soll«. 

Hier wird dem Objekt also eine aktive Rolle 
zugewiesen. Nicht länger modifzieren Prozedu- 
ren und Funktionen ihnen übergebene, passive, 
Daten, sondern Objekte werden durch den Emp- 
fang von Nachrichten (Messages) dazu veran- 
laßt, sich selbst zu manipulieren. Tatsächlich 
stellt ein Programm aus der Sicht eines OOPS- 
Programmierers eine Art großer Bühne dar, auf 
der die einzelnen Instanzen als die verschie- 
denen Schauspieler agieren, denen der Regisseur 


(das Hauptprogamm) Anweisungen in Form von 
Nachrichten übermittelt und sie dadurch zum 
Handeln veranlaßt. 

Dabei kommt ein weiteres wichtiges Prinzip 
der objektorientierten Programmierung zum tra- 
gen, das Prinzip der Datenabstraktion. Nur für 
das Objekt selbst sind nämlich die Objektvari- 
ablen, also seine Attribute, sichtbar und nur es 
selbst darf auf diese Attribute zugreifen. Jedem 
anderen Objekt und jeder normalen Prozedur 
oder Funktion ist der Zugriff auf das Innerste 
eines Objekts versperrt. Wie der Zugriff auf diese 
Attribute erfolgt zeigt Bild 7, in dem die Defini- 
tion der Init-Methode des KFZ-Objekts aufge- 
führt ist. 

Das kurze Listing zeigt, daß der Zugriff auf die 
Attribute mit Hilfe des sel f-Parameters erfolgt, 
der jeder Methode als implizites Argument über- 
geben wird und den Zugriff auf die Instanz er- 
möglicht, an die die entsprechende Nachricht ge- 
sandt wurde. Anstatt vor jeder der vier Zuwei- 
sungen hier self. zu schreiben, könnte man sich 
auch des with-Befehls bedienen, die Methode 
also durch den Befehl with self do einleiten. 


lie objektorientierten 


44 Bild 8: 

So kann eine Instanz 
der Objektklasse KFZ 
erzeugt und mit Hilfe 
der Methoden der 
Objektklasse mani- 
puliert werden. 


Features von QuickPascal 


c) 1989 by Michael Tischer 


In der Klassengesellschaft 
haben Stammbäume wieder 
Gewicht 


Zwei weitere wichtige Säulen des OOPS-Kon- 
zepts, das Prinzip der Vererbung (Inheritance) 
und des Polymorphismus (Polymorphism) 
möchte ich Ihnen am Beispiel des Demo-Pro- 
gramms deutlich machen, dessen Listing Sie auf 
den folgenden Seiten finden. Bild 9 läßt bereits 
erahnen, worum es in diesem Programm geht. 
Mit Hilfe der objektorientieren Erweiterungen 
von QuickPascal werden hier die drei geometri- 
schen Objekte Punkt, Rechteck und Dreieck defi- 
niert und Methoden bereitgestellt, die die Ob- 
jekte dazu bringen, auf dem Bildschirm zu er- 
scheinen und sich in einer bestimmten Richtung 
über den Bildschirm zu bewegen, wobei sie an 
den Bildschirmrändern reflektiert werden und 


Bild 9: 

Das Demo-Pro- 
gramm OOPDEMO 
läßt verschiedene 
geometrische Objekte 
über den Bildschirm 
tanzen. 
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dann eine neue Bewegungsrichtung einschlagen. 

Zunächst wird dazu die Objektklasse Punkt 
definiert. Innerhalb jeder Instanz dieser Klasse 
wird die Position der Instanz als Bildschirmkoor- 
dinate in den Variablen X und Y sowie die Bewe- 
gungsrichtung in der Variablen Richtung gespei- 
chert. Da es vier Bewegungsrichtungen gibt, die 
jeweils in diagonaler Richtung auf eine der vier 
Bildschirmecken zeigen, wird die Bewegungs- 
richtung als Wert zwischen 1 und vier fest- 
gehalten und als Index in das globale Array Bew- 
Da betrachtet. In diesem Array werden für die 
vier Bewegungsrichtungen die Offsets in X- und 
Y-Richtung sowie die möglichen Bewegungsrich- 
tungen für den Fall eines Zusammenpralls mit 
dem Bildschirmrand festgehalten. 

Punkt verfügt über sechs Methoden, die teils 
als Prozeduren, teils als Funktionen realisiert 
sind: 

° pinit initialisiert die Instanz, trägt ihre Bild- 
schirmposition in die Variablen X und Y ein und 
wählt eine zufällige Bewegungsrichtung aus, die 
es in die Variable Richtung einträgt. 

« draw zeichnet die Instanz an der Bildschirm- 
position, an der sie sich gerade befindet. 

° move verschiebt die Instanz in ihrer augen- 
blicklichen Bewegungsrichtung über den Bild- 
schirm und wählt eine neue Richtung, falls die 
Instanz mit dem Bildschirmrand kollidiert. 

« GetX liefert die Bildschirmspalte, in der sich 
die Instanz befindet. 

« GetY liefert die Bildschirmzeile, in der sich die 
Instanz befindet. 

* check überprüft, ob die Instanz, stellt man sie 
ab der übergebenen Bildschirmposition dar, noch 
auf den Bildschirm paßt oder mit dem Bild- 
schirmrand kollidiert. 

Bevor unser Augenmerk der Realisation dieser 
Methoden gelten soll, möchte ich Ihren Blick auf 
die Deklaration der Objekte rechteck und drei- 
eck leiten, die innerhalb des Listings der Deklara- 
tion von punkt folgen. Das Besondere an ihnen 
ist die Angabe des Objektnamens punkt in 
Klammern hinter dem Schlüsselwort object. 
Diese Art der Deklaration weist QuickPascal 
nämlich darauf hin, daß rechteck und dreieck 
Nachfahren der Objektklasse punkt sind. Da- 
durch »erben« sie alle Methoden und Variablen 
ihres Vorfahrens, können neben den eigenen 
Methoden und Variablen auch auf sie zugreifen. 

Hinter dem Prinzip der Vererbung verbirgt 
sich die Idee, immer komplexere Objekte aus ein- 
facheren Objekten zusammenzusetzen, so wie 
auch in unserer Umwelt viele Objekte (etwa PCs) 
aus in sich abgeschlossenen Objekten bestehen, 
deren Verbindung miteinander erst das Ganze 
ergibt. So könnte man aus rechteck und dreieck 
wiederum beliebig viele Objektklassen hervor- 
gehen lassen, die dann neben den Methoden und 
Variablen von punkt, auch die Merkmale ihrer 
direkten Vorfahren, also rechteck oder dreieck, 
erben. 


Während rein objektorientierte Systeme auch 
die »multiple inheritence« erlauben, die Erstel- 
lung eines Objekts aus mehreren Vorfahren, ist 
dies bei hybriden Sprachen in der Regel nicht 
möglich. Auch QuickPascal sieht nur die Verer- 
bung von Merkmalen durch jeweils einen Vor- 
fahren vor, doch zeigt die praktische Arbeit, das 
dies den Programmierer nur in solchen Fällen 
einengt, in denen bereits andere Gründe den 
Einsatz reiner OOPS-Systeme sinnvoll erscheinen 
lassen. 

Fahren wir mit der Betrachtung der Objekt- 
klasse rechteck fort. Auch Rechtecke besitzen 
eine (Ursprungs-)Koordinate in Bezug auf den 
Bildschirm und eine Bewegungsrichtung, doch 
müssen diese Informationen innerhalb der De- 
klaration nicht nochmals aufgeführt werden, da 
sie von punkt übernommen werden und dadurch 
(unsichtbar) bereits vorhanden sind. Hinzu 
kommen jedoch die Variablen XLen und YLen, die 
die Länge der horizontalen und vertikalen Seiten 
des Rechtecks widerspiegeln und dadurch aus 
einem Punkt ein Rechteck formen. 

Beachten Sie bitte, daß diese Variablen und 
auch die zusätzlich definierten Methoden nur der 
Objektklasse rechteck und deren Nachfolgern, 
nicht aber der Objektklasse punkt zur Verfügung 
stehen. Die Vererbung wirkt sich also immer nur 
in Richtung auf die Nachfahren aus. Die Vorfah- 
ren bleiben grundsätzlich unbeeinflußt! 

Da zur Initialisierung eines Rechtecks nicht 
nur dessen Bildschirmposition, sondern auch die 
Länge der beiden Seiten bekannt sein muß, wird 
die Objektklasse rechteck mit der Methode 
rinit versehen, die diese Parameter erfaßt und 
in die Variablen der Instanz einträgt. Darüber 
hinaus wird rechteck mit zwei eigenen Versio- 
nen der Methoden draw und check versehen, 
denn durch die unterschiedliche Form, kann 
rechteck nicht auf die gleichnamigen Methoden 
von punkt zurückgreifen. Da rechteck jedoch be- 
reits zwei Methoden mit diesen Namen von sei- 
nem Vorgänger geerbt hat, müssen die beiden 
Methoden-Deklarationen mit dem Schlüsselwort 
override versehen werden, damit QuickPascal 
erkennt, daß rechteck über eigene draw- und 
check-Methoden verfügt und nicht die geerbten 
Methoden zum Einsatz kommen sollen. 

Zwar könnte man dieses Problem leicht umge- 
hen, indem man der draw- und check-Methode 
von rechteck einfach einen anderen Namen 
verleiht, doch werden wir gleich noch sehen, daß 
die hier eingeschlagene Vorgehensweise in Bezug 
auf das Konzept des Polymorphismus besonders 
wichtig ist. 

Die Deklaration der Objektklasse dreieck 
unterscheidet sich nur wenig von der rechteck- 
Deklaration. Auch sie ergänzt die von punkt 
übernommenen Variablen um eine weitere In- 
formation, die die Länge der Grundseite des 
Dreiecks aufnimmt. Da es sich hier grundsätzlich 
um gleichschenklige Dreiecke handelt, kann die 


Länge der beiden Schenkel aus der Länge der 
Grundseite berechnet werden. 

Mit der Methode dinit verfügt auch dreieck 
über eine eigene Initialisierungsmethode und 
durch Überschreiben der von punkt übernomme- 
nen check- und draw-Methoden geht es auf seine 
spezielle geometrische Form ein. 


Die Methoden im Beispiel- 
programm OOPDEMO 


Bis auf die Methode move sind alle Methoden von 
punkt recht trivial und einfach zu verstehen. 
Pinit lädt die übergebenen Parameter in die 
Instanzvariablen, check prüft, ob sich die Instanz 
im sichtbaren Bildschirmbereich befindet, GetX 
und GetY liefern die Koordinate der Instanz zu- 
rück und draw setzt den Cursor mittels der Stan- 
dardprozedur GotoXy auf die Bildschirmposition 
des Punktes und gibt dann durch einen Aufruf 
von Write das Zeichen mit dem ASCII-Code 219 
aus, das auf dem Bildschirm als inverser Zei- 
chenblock erscheint. 

Wesentlich komplexer und interessanter ist da 
schon die move-Methode. Sie entfernt die über- 
gebene Instanz zunächst vom Bildschirm, indem 
sie die Textfarbe für Ausgaben über Write und 
Writeln auf O setzt und dann die draw-Methode 
der Instanz aufruft. Da die das Objekt eben 
genau mit Hilfe der Write-Prozedur auf dem 
Bildschirm aufbaut und die Textfarbe nun die 
Farbe des Bildschirmhintergrundes angenommen 
hat, entfernt sie die Instanz ungewollt vom Bild- 
schirm. 

Danach testet move mit Hilfe der check-Metho- 
de, ob sich die Instanz an der neuen Position, die 
sie nach ihrer Verschiebung inne haben soll, 
noch innerhalb des sichtbaren Bildschirmbereichs 
befindet. Ist dem nicht so, sucht move eine Bewe- 
gungsrichtung, in der die Instanz verschoben 
werden kann, wählt diese als neue Bewegungs- 
richtung aus und paßt die Bildschirmkoordinaten 
der Instanz entsprechend an. 

An die neue Bildschirmposition bringt move die 
Instanz, indem es wieder eine sichtbare Text- 
farbe einstellt und dann erneut eine Nachricht an 
die draw-Methode der Instanz sendet. 

Das alles macht move natürlich für Instanzen 
aus der Objektklasse punkt, doch der Clou ist, 
daß ein Programm auch auf diese Methode 
zurückgreifen kann, um die Nachfahren von 
punkt, also rechteck und dreieck über den Bild- 
schirm zu verschieben, ohne daß sie die move- 
Methode durch eine für sie angepaßte Version 
ersetzen. 

Möglich wird dies durch Vererbung und Poly- 
morphismus. Ersteres trägt dazu bei, daß die 
Nachfahren von punkt auch über die move- 
Methode verfügen, sie mittels einer Nachricht 
also aktivieren können. Dem Polymorphismus ist 
es andererseits zu verdanken, daß move nicht 


grundsätzlich die Methoden draw und check aus 
der Objektklasse punkt anspricht, sondern jeweils 
eine Nachricht an die draw- und check-Methode 
der Objektklasse sendet, zu der die Instanz ge- 
hört, die move aktiviert hat und auf die sich der 
sel f-Parameter bezieht. 

Dieser auf den ersten Blick recht einfach wir- 
kende Mechanismus hat auf die Codegenerierung 
ganz entscheidenden Einfluß, denn QuickPascal 
weiß bei der Kodierung der move-Methode noch 
nicht, welche draw- und check-Methode es (im 
prozeduralen Sinne) aufrufen muß. Die aus der 
Objektklasse punkt, oder die aus rechteck oder 
gar der Objektklasse dreieck? 

Diese Frage kann zum Zeitpunkt der Kompilie- 
rung einfach noch nicht beantwortet werden, 
und so ist QuickPascal gezwungen, ein soge- 
nanntes »late binding« durchzuführen, das nicht 
bereits zum Zeitpunkt der Kompilierung, sondern 
erst unmittelbar während der Programmausfüh- 
rung festlegt, an welche der verschiedenen draw- 
und check-Methoden eine Nachricht gesandt 
werden muß. Realisiert wird dies, indem für jede 
Objektklasse eine interne Tabelle mit den Adres- 
sen der zugehörigen Methoden angelegt und 
eine Objektinstanz über den New-Befehl mit die- 
ser Tabelle verbunden wird. Bei einem Aufruf 
einer Methode wird daher zunächst die Objekt- 
klasse ermittelt, zu der die bearbeitete Instanz 
gehört, und aus der Tabelle dieser Instanz dann 
die Adresse der aufzurufenden Methode geladen. 

Vergißt der Programmierer, eine Instanz über 
den New-Befehl mit dieser Tabelle zu verbinden, 
zeigt der zugehörige Tabellen-Zeiger in die 
Wüste und genau dorthin wird auch QuickPascal 
beim ersten Senden einer Nachricht an eine Me- 
thode springen. Um dies zu verhindern, emp- 
fiehlt es sich, während der Programmentwick- 
lung den Compilerschalter $M einzuschalten, der 
eine Instanz-Überprüfung vor dem Absenden 
jeder Nachricht an eine Methode durchführt. 
Stellt er dabei fest, daß die Verbindung zur In- 
stanz-Tabelle noch nicht aufgebaut wurde, bricht 
er die Programmausführung mit einem Laufzeit- 
Fehler ab. 

Mit diesem Wissen gewappnet, wird es ihnen 
nicht schwerfallen, die draw- und check-Metho- 
den von rechteck und dreieck zu verstehen. Et- 
was Neues halten dabei allein die beiden check- 
Methoden bereit. Sie nämlich bedienen sich der 
check-Methode aus der Objektklasse punkt, um 
festzustellen, ob jeweils alle Ecken der Figur 
noch auf den Bildschirm passen. Nur wenn dies 
gewährleistet ist, kann die Instanz von move an 
die angegebene Bildschirmposition verschoben 
werden. Da die beiden Methoden den gleichen 
Namen wie punkt.check tragen, müssen sie sich 
des Befehlswortes inherited bedienen, damit 
der Compiler erkennt, das hier nicht eine 
(rekursive) Nachricht an sich selbst gesendet 
werden soll, sondern die Nachricht vielmehr für 
die geerbte check-Methode bestimmt ist. 
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P>» Listing 1: 
OOPDEMO.PAS 
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Das Hauptprogramm 


Innerhalb des Hauptprogramms werden auf der 
Basis des Zufallsgenerators so viele Objekte er- 
zeugt, wie die Konstante ANZ_OBJEKTE angibt. 
Um diese Objekte verwalten zu können, werden 
drei Arrays von dieser Größe angelegt. Eines für 
Punkte, eines für Rechtecke und eines für Drei- 
ecke. Leider können die verschiedenen Objekte 
nicht in einem Array verwaltet werden, denn wie 
es nicht möglich ist, verschiedenartige records in 
einem Array unterzubringen, so können auch In- 
stanzen aus unterschiedlichen Objektklassen 
nicht in einem Array zusammengefaßt werden. 

Nach der Erzeugung der Objekte tritt das Pro- 
gramm in eine Schleife, die erst beendet wird, 
wenn der Anwender die Leertaste oder Return 
betätigt. Innerhalb dieser Schleife werden die 
verschiedenen Objekte fortwährend mit Hilfe der 
move-Methode über den Bildschirm bewegt, was 
zumindest für meinen Geschmack ganz witzig 
aussieht. 


Perspektiven 


Obwohl der Grundstein zur objektorientierten 
Programmierung bereits im Jahre 1967 von den 
Forschern Nygaard und Dahl mit ihrer Sprache 
»Simula« gelegt wurde, breiten sich die damit 
verbundenen Ideen erst langsam in der Pro- 
grammierer-Gemeinschaft aus, und es wird wohl 
noch eine ganze Weile dauern, bis das objekt- 
orientierte Paradigma unseren heutigen Pro- 
grammierstil ablösen wird. Bereits jetzt aber wird 
deutlich, daß die objektorientierte Programmier- 
technik zum Wohle der Programmierer einge- 
setzt werden kann, um große Software-Projekte 
durchschaubarer zu machen, die Wiederver- 
wendbarkeit des Programmcodes zu steigern und 
die Fehleranfälligkeit zu reduzieren. Dem Pro- 
grammierer eröffnen sich damit Perspektiven, die 
ihm die Möglichkeit bieten, auch in den 90er 
Jahren mit den wachsenden Anforderungen des 
Marktes Schritt halten zu können. QuickPascal ist 
dabei der erste und vielleicht entscheidende 
Schritt. 

Michael Tischer 


[een nennen nannten 


* OOPOEND : demonstriert die objektorientierten Features von QuickPascal « 


% anhand mehrerer Objekte, die sich über den Bildschirm bewegen * 
g und dabei vom Bildschirmrand reflektiert werden. r 
- .. 
* Autor x MICHAEL TISCHER > 
* entwickelt am 22.07.1989 & 


* letztes Update am: 


AunnsnsensntnenInn anne ann nn nern ernennen nennen nennen) 
IH-] { Objekt-Initialisierung nicht mehr überprüfen ] 
program oopdemo; 


uses Ort; { Unit mit GotoXY, CirEol etc. } 
const ANZ OBJEKTE = 10; | Anzahl zu erzeugender Objekte | 
{== Objekt- und Typdeklarationen =s===ssu0s=ss2120n22s2a00n02suns0n000nnnnnne] 


type RDaten = record 
NeueRichtung : array [1..3] of by‘ 
eine MoveY : integer; 
end; 


{ Daten für die Reflektion an einer Wand 
te; { Richtungscodes 
{ Richtungsoffsets 


type BR = object { das Basisobjekt ist der Punkt 
%, 


: Integer; [ Position auf dem Bildschirm 
ER byte; ( Bewegungsrichtung 
procedure pinit( XPos, YPos + integer); 
procedure draw; { Objekt malen 
procedure move; { Objekt verschieben 
function GetX : Integer; %-Pos holen 
function GetY : integer; Y-Pos holen 


function check{ NeuX, NeuY : Integer ) : boolean; 
end; 


type been = object( punkt ) 
„ Yen : integer 
ee rinit( Pos, YPos, X, di: Integer ); 
function check( NeuX, NeuY : Integer ) : boolean; override; 
LPFOSSSEIE draw; override; 
end; 


| Rechteck folgt aus dem Punkt 
{ Seitenlängen 


type dreieck = object( punkt ) { ein gleichschenkliges Dreieck 
SLen : Integer; I Seitenlängen 
procedure dinit( XPos, YPos, dS : integer h 
function check( NeuX, NeuY : Integer ) : boolean; override; 
procedure draw; override; 


end; 
{"= initlalisierte globale Varfablen (typisierte Konstanten) ==mummum anuununn) 
const BewDa : array [1..4) of Anaten = | Bewegungsdaten für Reflektion ] 
Neuekichtung :( 4, 2, ; MoveX : 1; MoweY : -1 ), 


; MoveX : -1; MoveY : -1 ), 
; MoveX : -1; MoveY : 1 I» 


Neuerichtung :( 2 
; MoveX : 1; MoveY : 1 


3 
Neuerichtung | EM ii N 
' Neuerichtung : 


(== Methoden des Objekts Punkt =====u=ne2222.: Euunnszusnneuonunnennne] 
Inennsnnnunnannnnnensnsnnnensennnsen nennen enenennnnsetennnnnuannun nennen 
* PÜUNKT.PINIT: lädt die Koordinate eines Punktes (bzw. eines nachfolgenden * 
% Saat) {n die Objekt-Varlablen X und Y und wählt eine zu- * 


In lige Bewegungsrichtung aus. 
N. naher Re 
* Eingabe : X, Y = Koordinate des Objekts “ 


jabe : keine 
(antterteeebbesnenenturhern ebenen Teen enden essen ehe] 


Fessaıa punkt.pinit( XPos, YPos : Integer); 
n 


self.X := XPos; self.Y := YPos; 
self,Richtung := Randam( 3 ) + 1; 


{ Position merken 
{ Bewegungsrichtung auslosen 


[eeesaneeenennnnennnnnntenenennen nennen nennen sen 
* PUNKT.CHECK : stellt fest, ob die Koordinate des übergebenen Bildschirm- * 
R punktes noch innerhalb des Bewegungsbereichs der Objekte * 
® auf dem Bildschirm liegt. 2 
ed — ie is MET eur 7, 
" Eingabe Y = Bildschrimposition 

Br Ausgabe : TRUE, wenn der Punkt noch innerhalb des Bewegungsbereichs Hest,: 
° sonst FALSE. 


BETROERERSÄRN et RENNER ER TER ROSER BIER EFF IITR 


function punkt.check( NeuX, NeuY : Integer ) : boolean; 


begin 
check := (NeuX >= 1} and (NeuX <= 80) and (NeuY >= 2) and (Neuf <=24); 
end; 


jaennnennunenennnanennensunnnnnennen nennen nennen nennen nennen 
* PUNKT.GETX : liefert die Spalte, in der sich ein Objekt vom Typ PUNKT e 
® oder eines der nachfolgenden Objekte befindet. . 
.. “. 
* Eingabe : keine . 
* Ausgabe : Spalte des Objekts ® 


#erTnhänntennshunhannnhheehennahn here] 


function punkt.GetX : Integer; 


wen 
etX := self.X; 
end; 


I Spaltenposition aus dem Objekt holen | 


[Hernsnnnnannennnnennneennn nennt nannten anna ernennen 


* PUNKT.GETY : Mefert die Zeile, in der sich ein nee vom Typ PUNKT oder * 
» eines der nachfolgenden Objekte befi Ä 
* Eingabe : keine be; 
* Ausgabe : Zeile des Objekts r 


Kuetnsinrkinseennnihnhene rien nunee hier nennen nennen] 


function punkt.GetY : Integer; 


in 
Ex NY := self.Y; 4 Zetlenposition aus dem Objekt holen | 
; 


— tete 


* PUNKT.DRAW : Malt ein Objekt vom Typ PUNKT in der aktuelle eingestellten * 
s Ausgbefarbe P 


* Eingabe : keine . 
* Ausgabe : keine « 
* Info : Diese Methode wird von der Methode MOVE aufgerufen, um das m 
° DaleKe auf dem Bildschirm zu zeichnen oder vom Bildschirm zu 2 

} 


. 
DLEELDEETTEITIE EEE SETZE EETESE TEE EETEZ 


Be lure punkt.draw; 

n 

Be self.x, seif.Y ); 
write( T 


{ Cursor auf Objekt-Position setzen 
{ Punkt zeichnen 


wnenntienheeeeneen een een ehe 


PUNKT.MOVE : verschiebt ein OBJEKT vom Typ PUNKT oder eines der nachfol- * 


. genden Typen in der aktuellen Bewegungsrichtung über den ® 
“ Bildschirm. Stößt das Objekt dabei an den Rand’des Bewegungs-* 
« bereichs, wird die Bewegungsrichtung so verändert, daß das * 
% Objekt sich weiter bewegen kann. 5 
Tg 

* Eingabe : keine . 
* Ausgabe : keine =, 


sernuusnnnennten une as nneee nennen nenne rennen nennen] 
procedure punkt .move; 


var i,r ; byte; { dienen der Berechnung einer neuen Bewegungsrichtung |} 


begin 
with Yill do { auf die Felder des Objekts zugreifen | 
n 

MKuRlor 0) { Zeichen unsichtbar machen 

draw { Objekt ausblenden 

if are not check( - + Bewdalself.Richtung] ‚MoveX, { Crash? 

+ BewdalRichtung].Mover ) ) then 
in f Ja, neue Richtung suchen ) 
= 0; 
repeat { nach einer neuen Richtung suchen 
inet 1); Index für AL NEROREDIRT inkrementieren 


{ 
rı= Bewdart chtung] .Neverichtung[i]:; RN hass Richtung 
until check( X + [r].Movex, Y + BewDa[r] SI: BoNe 
ag rn { neue Richtung Vkssen, merken | 


ne x ROSTRTT „MoveX { Bewegung In neue Richtung } 
inel Y, BesüafRichtun Mi Y} :g 3, 


Tentcoort 7 { Zeichen wieder sichtbar machen 
ae { Objekt an neuer Pos, zeichnen 
; 


end; 
{== Methoden des Objekts Rechteck == 


DEI EEE ET EEE TEST 


* RECHTECK.RINIT : initialisiert ein Objekt vom Typ RECHTECK, indem es die * 
‘ Position des Objekts sowie dte Länge der beiden Seiten * 
& speichert. 

* Eingabe : X, Y = Koordinate des Objekts 

% 4X = Seitenlänge horizontal 

I< di = Seitenlänge vertikal 

2 ‚Ausgabe ; keine 


EEE ELEEIEEETES EEE SEE EEE 


rechteck.rinit( XPos, YPos, dX, dY : Integer); 
n 
self.Xlen := dX; { Seitenlängen merken } 


self.YLen := dY; 
EAREN XPos, YPos ); { Objekt inttialisteren | 
i 


EuEnEnuEnnunnnunTunnunsrununennennnnnnn] 


EEE TESTSEITE 


*  RECHTECK.CHECK : zus es ob sich das Übergebene Objekt vom Typ RECHT-* 
ECK noch Innerhalb des Bewegungsbereichs der Objekte auf * 

: dem Beldschirm befindet. 

* Eingabe : NeuX, Neuf = Au: sposition für das zu überprüfende Recht- 

* Ausgabe : TRUE, wenn das noch innerhalb des Bewegungsbereichs 

liegt, sonst FALSE. 

Info  : Der Test wird führt, indem die Gültigkeit der Koor- 
dinaten der vier Ecken des Rechtecks mit Hilfe der Methode 
PUNKT.CHECK überprüft wird. 


EEE ET III 


Dccıes rechteck.check( NeuX, NeuY : integer ) : boolean; 


RR := inherited self.check( NeuX, NeuY ) and 
inherited self.check( NeuXtself. XLen-1, Neuy ) and 
inherited self.check( NeuX+self.XLen-1, Neuf+self.YLen-i ) and 
Inherited self.check( NeuX, Neuf+self.YLen-1 ) 


end; 
EEE EEE Ze 


RECHTECK.DRAW : mal ein Objekt vom Typ RECHTECK an seiner augenblick- 
lichen Position auf dem Bildschirm 


Eingabe : keine 
Kusmabe  koibe 


Info : Diese Methode wird von der Methode MOVE aufgerufen, um das 
Di auf dem Bildschirm zu zeichnen oder vom Bildschirm zu 
entiernen. 


.ur0ng* 


procedure rechteck.draw; 
var 1 : byte; \ { Schleifenzähler } 


begin 
with self do { auf die Felder des Objekts zugreifen | 
n 
T obere Linie zeichen — — } 
toRY( self.GetX, self.Gety ); Write('r'); 
for | := 1 to XLen-2 do writel '-' ); witelh"); 


d— senkrechte Linien zeichnen —————— 
for i := 1 to Ylen- 1 do 
n 


" self.Getk, self.GetY + 1 ); write "|" ); 
PR ea self.GetX + Xlen - 1, self,GetY + 1 ); write( "|" ); 


4 untere Linie ziehen —— 2} 


GotoXY( self.GetX, self.GetY + YLen - 1); Write('t'); 
for I := I to XLen-2 do write( '-' ); Write('4'); 
end; 
end; 


(v= Methoden des Objekts Dreieck „mannunnnunsnesunnnnnsssununnnenennnnanunne] 


EEE EEE TESTSEITE ESS EETTETETTEeTe 


* DREIECK.DINIT : initialisiert ein Objekt vom Typ DREIECK, indem es die nd 
hd Position des Objekts sowie die Länge der Grundseite 
Br speichert. 

mm  —— 
* Eingabe : X, Y = Koordinate des Objekts 
x 45 = Länge der Grundseiten 
a dY = Seitenlänge vertikal 


... 


* Ausgabe : keine ® 
* Info : die an et der beiden Schenkel entspricht der halben Länge der hr 


2 . 
Pnuntennnnenteene en nee] 


ee dreieck.dinit( XPos, YPos, dS : Integer); 


n 
self.Slen := dS or 1; { Seiten muß ungerade sein 
self.pinit( XPos, YPos ); jekt initialisieren 
D 
ee 


* DREIECK.CHECK : stellt fest, ob sich das übergebene Objekt vom Typ DREI- * 
ECK noch innerhalb des Bewegungsbereichs der Objekte auf * 
dem Bildschirm befindet. 

. 


Eingabe : NeuX, Neuy = die zu überprüfende Ausgangspositon des Dreiecks 
: TRUE, wenn das Objekt noch innerhalb des sbereichs 
1egt, sonst FALSE. 

Info : Der Test wird durchgeführt, indem die Gültigkeit der Koor- 
en der drei Ecken des Dreiecks mit Hilfe der Methode 

PUNKT.CHECK überprüft wird. 


ESIEEST EEE TEE E ET en 


function dreieck.check( NeuX, NeuY : Integer ) : boolean; 


mon..." 
er ze 


begin 
check := inherited self.check{ NeuX, MeuY ) and 
inherited self.check( NeuX + self.SLen — 1, HeuY ) and 
inherited self.check( NeuX + ( self.SLen shr 1 } 
Neuy — ( seif.SLen shr 1) ); 
end; 
nesttanennennneennen nn nn Ener ern RER nen Ener ernennen ee 


DREIECK.DRAW : mal ein Objekt vom Typ DREIECK an seiner augenblicklichen * 
. Bildschirmosition a 


” 
» Eingabe : keine . 
* Ausgabe : keine ir 
* Info : Diese Methode wird von der Methode MOVE aufgerufen, um das 7. 
g Objekt auf dem Bildschirm zu zeichnen oder vom Bildschirm zu x 
. 

FEERRENSOR 1.1 EREUNIEEREERNENENUREENE + 


procedure dreieck.draw; 
var 1 : byte; ( Schleifenzähler } 


begin 
with Het do { erlaubt den Zugriff auf die Felder des Objekts } 


n 

— Grundseite malen —.  — — — —— — ——  } 
GotoxY( self.GetX, self.GetY li 
for 1 := } to SLen do write( '® ); 

— die beiden Schenkel zeichen ———— ] 
or I := I to ( Slen shr 1) do 


u HM self.GetX + 1, self.GetY - 4 ); write( '*' ); 
GotoXY, self.GetX + Sten - 1 - 1, self.GetY - 1 ); write( ar) 


WuUNSEREEnLEEESnuEIEE En nnnn en 


ı array 1. Tanz OBJE of rechteck; { Arraya mit jeweils 

: array [1..ANZ/OBJEKTE] of dreieck; { einem Typ von Objekt 

: array [1.. of punkt; 
anzr, Anzahl der Dreiecke, Punkte und Rechtecke | 
anzd, 
anzp 
1 : Integer; { Schleifenzähler ] 
Al + char; { zum Abfragen der Taste 
n 

ndane: { Zufallsgenerator Initialisieren ] 


er Bildschirm aufbauen 
TextColor( 7 ); TextBackground( 0 ); { normale Schrift 
UrScer; { Bildschirm löschen 
TextColor( 0 ); Text8ackgroundt 7 ); { Inverse Schrift 
ClrEol; ( erste Bildschirmzeile invertieren 
write( ' OOPDEMO — demonstriert die objektorientierten Features’, 


* von QuickPascal' ); 
GotoXy( 1, 25 ); { Cursor in letzte Bildschirmzeile 


Clrkol; l und auch die invertieren 
write( ' SPACE » neuer Durchlauf | RETURN = Ende IF 
"(c) rg AT; Michael Tischer' ih 
TextBac HN auf schwarz setzen 
anzr ı= ibt bisher weder Punkte, 
anzd := 0; Kreise, noch Dreiecke 
anzp := 0; 
Gr Objekte aa erzeugen 
or 1 := 1 to ANZ OBJEKTE do { ANZ_OBJEKTE erzeugen 
case ale] öf { Art des hp ed auslosen 
0: tl kt erzeugen 
Hr % { Anzahl Punkte inkrementieren 
ne nzp ] ) Objekt erzeugen 
ER pl A "].pintt| Random(79)+1, Randan(24)+2 ); 
1% in { Rechteck erzeugen 
IL an An { Anzahl TREUEN 
(t erzeugen 
ar Ex! Fr RN "handen ‚60)+1, Random! Ba 
ne; indom{10)+3, Random 5)+2 } 
2 begin ( Dreieck erzeugen 
inc ing % { Anzahl Dreiecke inkrementieren 
nem 


anzd ] ); Objekt erzeugen 
al Helmet Random(60)+1, Random(10)+14, Randamt7)43 )e 
# 
end; 
_ kte bewegen, bis eine Taste betätigt wird — 
Ir A e ” La 2 . { noch keine Taste betätigt ] 
{ die Objekte durchlaufen } 
{ gibt es Dar einen Punkt? 
{ Ja, Punkt bewegen 


repeat 
for 1 := 1 to ANZ_OBJEKTE do 


vn 1 <= anzp ) then 


pl 1 ].move; kt 
1 (1 <= anzr ) then I gibt es noch ein Rechteck? 
rl i ].move; I Ja, Rechteck bewegen 
4f {1 = anzd ) then { gibt es noch ein Dreieck? 
ug di t ].move; { Ja, Dreieck bewegen 
’ 
nn ia sed then { wurde eine Taste betätigt? } 
n 
ch := Readkey { betätigte Taste holen 
#lch=-® j then { erweiterter Tastaturcode? 
begin I Ja, Taste holen aber nicht verwerten 
ch := Readkey; 
ch ı= #0; { Taste wegwerfen ) 


end; : 
until (ch= '*)or(ch*- 43); 


— die erzeugten Objekte wieder löschen 
ri := I to ANZ_OBJEKTE do 


{ die Objekte durchlaufen 


A A I gibt es noch einen Punkt? 
disposef pf I J ); { Ja, löschen 
f (fi <= anzr ) then { gibt es noch ein Rechteck? 
disposel rl 1 ] IB 1 Ja, löschen 
if (1 <e anzd ) ti { gibt es noch ein Dreieck? 
dispose( dL 1] I; { Ja, löschen 

# 
until (ch= 93): { wiederholen, bis Return betätigt wurde 
A) { Bildschirm löschen 


Listing 1: 
Fortsetzung und 
Ende. 
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y 
Kompromisse. 


erwacht MS/BOS| | a. 
A\NYALLLNJER 2 


Perfekte Software ohne Kompromisse 
braucht gerade heute »Optionen auf die 
Zukunft«. An die Stelle von kurzfristig 
passenden Einzellösungen müssen aus- 
gebaute und ausbaubare Konzepte tre- 
ten. Neben dem perfekten Einzelprodukt 
muß die jederzeit realisierbare, daten- 
kompatible Ausweitung in ein System 
stehen, damit die Software-Lösungen 
mit den Software-Anforderungen eines 
Unternehmens wachsen können. 


Microsoft hat deshalb von Anfang an in 
einer kompletten Applikationen-Familie 
gedacht und diese konsequent weiter- 
entwickelt. Dabei haben Mitglieder wie 
MICROSOFT WORD oder MICROSOFT 
MULTIPLAN den Standard ihrer Klasse 
gesetzt. Dies bestätigt zusätzlich die 
Marktentsprechung dieses Konzeptes, 
mit dem die Marke Microsoft sich von 
anderen differenziert. 


MICROSOFT WORD, MICROSOFT MULTI- 
PLAN, MICROSOFT CHART und MICRO- 
SOFT PROJECT haben die gleiche Bedie- 
neroberfläche und eine einheitliche 
Tastatur- oder Mausbedienung. Alle tau- 
schen untereinander perfekt Daten aus 
und unterstützen auch die technologisch 
neuesten Peripheriegeräte. Microsoft 
Applikations-Software ist für alle ange- 
botenen MS-DOS Personal Computer 
geeignet. Vom 8088-Laptop bis zum 
486-Top-Modell. Alle Produkte sind in 
PC-Netzen einsetzbar. Mit MICROSOFT 
MULTIPLAN 4.0 sowie MICROSOFT 
WORD 5.0 stehen darüber hinaus die 
ersten echten OS/2-Anwendungen von 
Microsoft zur Verfügung. 


Damit bedeutet die Entscheidung für 
Microsoft Applikationen den Einstieg in 
ein »offenes System«, dessen Integra- 
tionsgrad und jeweiliger Leistungs- 
Umfang vom Nutzer oder Entscheider 
bestimmt werden, statt von Software- 
Engpässen. Und das - so meinen wir - 
ist eine der Freiheiten, die man sich 
leisten sollte. Damit Ihre Software jetzt 
und in Zukunft alles leisten kann. 


Microsoft 


MICROSOFT | MICROSOFT WORD ZUKUNFT DER SOFTWARE 


| MULTIPLAN Textverarbeitungs- 
Tabellenkalkulations- programm 
programm MS/DOS MS /O8/2| | mt 
IMS/ DON) IMS /OS/Z| | mE 
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OOP unter QuickPascal und 
Turbo Pascal im Vergleich 


E s sind in der letzten Zeit mehrere Artikel 
über die objektorientierten Möglichkeiten 
von QuickPascal und Turbo Pascal erschienen. 
Viele dieser Artikel enthielten technische und 
sachliche Fehler. So wurde beispielsweise in eini- 
gen Artikeln behauptet, daß QuickPascal keine 
virtuellen Methoden enthält, während es tatsäch- 
lich so ist, daß in QuickPascal alle Methoden vir- 
tuell sind. In einigen Artikeln wurde das frühe 
und das späte Binden (»early binding«/ »late bin- 
ding«) besprochen und es wurde dort behauptet, 
daß das späte Binden zur Laufzeit irgendeine 
zeitaufwendige Suche notwendig macht; dies ist 
nicht so. 

In diesem Text werden mehrere technische 
Themen besprochen, die beim Vergleich von 
Turbo Pascal und QuickPascal wichtig sind. Die 
Absicht dieses Artikels ist es, Fehler zu korrigie- 
ren und klarzustellen, worin die Unterschiede 
zwischen den objektorientierten Erweiterungen 
dieser beiden Produkte bestehen. 


Dynamische oder statische 
Objekt-Allokierung 


Dies ist sehr einfach; es entspricht völlig der 
Deklaration von Variablen oder Zeigern auf 
Variablen. Bei der traditionellen Programmie- 
rung ist es besser, ein Datum mit variabler 
Größe, ein sehr großes Datum oder eines mit 
unbestimmter Größe dynamisch zu allokieren. 
Anstatt eine Variable zu deklarieren, deklariert 
man einen Zeiger auf eine Variable und 
»dereferenziert« ihn, wenn erforderlich. 

Bei der Objektoriertierten Programmierung 
(OOP) kann der Platz für die Daten eines Objekts 
statisch im Daten- oder Stacksegment allokiert 
werden (statische Allokierung) oder man kann 
das Objekt dynamisch auf dem Heap allokieren 
(dynamische Allokierung). Es ist zu beachten, 
daß hier die Terminologie etwas irreführend ist, 
da »statische« Objekte, die lokal in einer Proze- 
dur deklariert werden, nicht in demselben Sinn 
»statisch« sind, wie es globale Variablen sind. 
Wie lokale Variablen, werden lokale »statische« 
Objekte beim Eintritt in eine Prozedur auf dem 
Stack allokiert und beim Verlassen der Prozedur 
wieder deallokiert. 

Der Vorteil dynamischer Objekte besteht darin, 
daß sie keinen Platz im Daten- oder Stackseg- 
ment benötigen (dort ist sowieso nur begrenzt 
Platz) und sie können nach Bedarf allokiert und 
deallokiert werden. Der Nachteil dynamischer 
Objekte besteht darin, daß sie beim Zugriff 
immer dereferenziert werden müssen, sie sind 
also langsamer. 

Auf statische Objekte kann man schneller zu 


greifen, sie belegen jedoch Speicher im Stack- 
und Datensegment. Es ist darüber hinaus sehr 
wahrscheinlich, daß gut strukturierte Pro- 
gramme, die ausgiebig Prozeduren und Funktio- 
nen verwenden, die Vorteile statischer Objekte 
verringern werden. (Sobald eine statisches Ob- 
jekt als ein Argument einer Prozedur übergeben 
wird, wird es im Prinzip, besonders aus Perfor- 
mance-Sicht, ein dynamisches Objekt.) 


Virtuelle Methoden 


C++ und Turbo Pascal 5.5 erlauben sowohl vir- 
tuelle als auch nicht virtuelle Methoden; in 
QuickPascal sind alle Methoden virtuell. Virtuelle 
Methoden sind Methoden, auf die indirekt über 
eine »virtuelle Methoden-Tabelle« (eine Sprung- 
tabelle) zugegriffen wird. Ein Objekt, daß virtu- 
elle Methoden verwendet, sieht im Speicher so 
a 


us! 
ie am | [Beier urn 1] 
— 


Die Struktur der VMT wird von der verwende- 
ten Klassenhierarchie bestimmt. Ein Beispiel in 
QuickPascal: 


{ QP Code } 
type 
shape = object 
procedure draw; 
procedure erase; 
end; 


cube = object (shape) 
procedure draw; override; 
procedure rotate; 
end; 


Die virtuelle Methoden-Tabelle für »shape« hat 
zwei Einträge: einen Zeiger auf den Code der 
Prozedur »draw« und einen Zeiger auf den Code 
der Prozedur »erase«. Die virtuelle Methoden- 
Tabelle für »cube« hat drei Einträge: einen für 
»draw«, einen für »erase« und einen für »rotate« 
(in dieser Reihenfolge). In »cube« zeigt der Ein- 
trag für »erase« auf genau den gleichen Pro- 
grammcode, wie in der Tabelle für »shape«, da 
dieser Code übernommen wurde (inherited). Der 
Eintrag für »draw« zeigt auf neuen Programm- 
code, da dieser übergangen wurde (override). 
Der Eintrag für »rotate« besteht ebenfalls aus 
neuem Code, da es sich hier um eine hinzuge- 
fügte Methode handelt. Die Struktur der VMT 
wurde übernommen (inherited). Die beiden 
ersten Einträge von »cube« (und jeder Unter- 
klasse von »shape« oder »cube«) sind immer Zei- 
ger auf die Prozeduren »draw« und »erase«. Der 
Vorteil davon ist, daß man dies schreiben kann: 


procedure ReDrawAThing( o : shape ); 


jegin 
o.Erase; 
o.Draw; 


eid; 

begin 
RedrawAThing( s ); 
ReDrawAfhing( c ); 


end; 


Da auf virtuelle Methoden immer indirekt über 
die VMT zugegriffen wird, ruft die Prozedur Re- 
DrawAThing immer den »richtigen« »draw«- und 
»erase«-Code auf. Wenn im obigen Beispiel 
»draw« und »erase« keine virtuellen Methoden 
wären, würde der Code von ReDrawAThing die 
Tatsache ignorieren, daß »cube« die »draw«- 
Methode übergangen hat und immer den 
»draw«-Code von »shape« aufrufen, da der Para- 
meter »o« als Objekt vom Typ »shape« deklariert 
wurde. 

Die Vorteile virtueller Methoden sind die 
wesentlich bessere Wiederverwendbarkeit von 
Code und wesentlich logischeres Verhalten. Im 
obigen Beispiel macht es Sinn, daß der neue 
Methodencode aufgerufen wird, da der Code für 
»draw« in der »cube«-Klasse übergangen wurde. 
Die ausgiebige Verwendung virtueller Methoden 
ist in gut entworfenem, objektorientiertem Code 
häufig. 

Der Nachteil virtueller Methoden ist der lang- 
samere Zugriff. Nicht virtuelle Methoden werden 
in einfache Aufrufe ohne Indirektion aufgelöst. 


Konstruktoren und 
Destruktoren 


Konstruktoren und Destruktoren sind besondere 
Methoden, die bei der Initialisierung und Been- 
digung eines Objekts behilflich sind. In C++ 
sind die Konstruktoren und Destruktoren sehr 
leistungsfähige Bestandteile. Der Compiler ruft 
die Konstruktoren und Destruktoren automatisch 
auf, wenn Objekte deklariert und wenn sie been- 
det werden. Bei statischen Objekten in einer Pro- 
zedur (und als solche werden sie auf dem Stack 
allokiert) kann dies sehr angenehm sein, da 
C++ die Destruktoren von Objekten aufruft, so- 
bald die Objekte ihren Gültigkeitsbereich verlas- 
sen (z.B. wenn die Prozedur verlassen wird). 
Dieser automatische Aufruf ist ein wichtiger 
Aspekt der Konstruktoren und Destruktoren in 
C++. 

Turbo Pascal 5.5 verwendet die Konstrukto- 
ren/Destruktoren-Terminologie, implementiert in 
Wirklichkeit jedoch die Funktionalität von C++ 
nicht. In Turbo Pascal müssen Konstruktoren ex- 
plizit aufgerufen werden und unterscheiden sich 
nur wenig von normalen Methoden. Die beiden 
einzigen Eigenheiten der Konstruktoren in Turbo 
Pascal 5.5 sind: 


1.Man muß einen Konstruktor aufrufen, um die 
virtuelle Methoden-Tabelle für ein Objekt ein- 
zurichten, das virtuelle Methoden verwendet. 

2. Konstruktoren können als Teil von »new« auf- 
gerufen werden: 


{ TP 5.5 code } 
type 
point = object 
x, y : integer; 
constructor init; 
procedure draw; virtual; 
end; 
var 
pp : “point; 
begin 
new( pp, init); 
end; 


Die Destruktoren von Turbo Pascal 5.5 sind im 
Vergleich zu C++ ähnlich eingeschränkt. In 
Turbo Pascal 5.5 besteht der einzige Unterschied 
zwischen einer Destruktor-Methode und einer 
normalen Methode darin, daß ein Destruktor bei 
»dispose« aufgerufen werden kann: 


{ TP 5.5 code } 
type 
point = object 
x, y : integer; 
constructor init; 
destructor done; 
procedure draw; virtual; 
end; 
point3d = object (point) 


z : integer; 
destructor done; 
end; 
var 
pp : “point; 
p3p : “point3d; 
procedure goaway( var p : point); 
begin 
dispose( p, done); 
end; 
begin 


new( pp, init); 

new( p3p, init); 

goaway( pp ); 

goaway( p3p ); 
end; 


Das Besondere an den Destruktoren von Turbo 
Pascal 5.5 ist, daß sie, wenn sie als Teil von 
»dispose« aufgerufen werden, die Anzahl der zu 
deallokierenden Bytes übergeben. Im obigen Bei- 
spiel deallokiert die Prozedur »goaway« die rich- 
tige Anzahl Bytes, da die Destruktoren dem 
»dispose«-Aufruf diese Information übergeben. 

QuickPascal verfügt nicht über Konstruktoren 
und Destruktoren, da es sie nicht braucht. Quick- 
Pascal richtet die virtuelle Methoden-Tabelle 
automatisch ein, wenn ein Objekt allokiert wird. 
Der »dispose«-Aufruf in QuickPascal deallokiert 
automatisch die richtige Anzahl Bytes wenn ein 
Objekt freigegeben wird (sogar in einer Prozedur 
wie »goaway«, in der das Objekt als Parent dekla- 
riert wurde). Der »dispose«-Aufruf weiß die rich- 
tige Anzahl Bytes, die deallokiert werden müs- 
sen, da diese Information als Teil der virtuellen 
Methoden-Tabelle gespeichert wird. In Quick- 
Pascal könnte das obige Beispiel so codiert wer- 
den: 
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{ QP code } 
type 
point = object 
x, y : integer; 
procedure init; 
procedure done; 
procedure draw; 


end; 
point3d = object (point) 
z : integer; 
procedure done; override; 
end; 


pp : point; 
p3p : point3d; 


procedure goaway( var p : point); 
begin 

dispose( p ); 
end; 


begin 
new( pp ); 
pp.init; 
new( p3p ); 
p3p. init 
goaway( pp ); 
goaway( p3p ); 
end; 


Binde-Strategie und 
Performance 


Als »Binden« wird bezeichnet, wie ein Compiler 
einen Methoden-Aufruf in wirkliche Maschinen- 
befehle umsetzt, die den entsprechenden Code 
aufrufen. Das Binden wird von zwei Dingen be- 
einflußt: statische oder dynamische Objekt-Allo- 
kierung und virtuelle oder nicht virtuelle Metho- 
den. Wir wollen zunächst untersuchen, wie auf 
die Daten eines Objekts zugegriffen wird. 

Bei der statischen Objekt-Allokierung werden 
Objekte im Daten- oder Stacksegment allokiert, 
abhängig davon, ob es sich um globale oder 
lokale Objekte handelt: 


alube Speicher für Objekt 


Im Fall eines globalen statischen Objekts ist 
der Name des Objekts eine direkte Speicherrefe- 
renz. Der Zugriff auf die Daten des Objekts ist 
ein direkter Speicherzugriff, der keine Indirek- 
tion erfordert. In Assembler würde das etwa so 
aussehen: 


MOV AX, Datenadresse 


Dies ist identisch mit dem Zugriff auf globale 
Variablen. 

Der Zugriff auf Daten bei einem dynamischen 
Objekt erfordert eine Ebene der Indirektion. Im 
Speicher sieht ein dynamisches Objekt etwa so 
aus: 


aCube | Zeiger auf Speicher Speicher für Objekt 
für das Objekt —> |... 


Um also auf eine Vorkommen-Variable eines 
dynamischen Objekts zuzugreifen, muß in As- 
sembler etwa folgendes gemacht werden: 


LES DI, aCube 
MOV AX, ES:[DI+Datenoffset] 


Es ist zu beachten, daß in beiden Fällen, 
sowohl bei statischen als auch bei dynamischen 
Objekten, zur Laufzeit keine Suche erforderlich 
ist. In beiden Fällen kann der Compiler beim 
Kompilieren alle Informationen feststellen, die er 
wissen muß: bei statischen Objekten die ge- 
wünschte Datenadresse, bei dynamischen Objek- 
ten den Offset der Daten im Speicher des Ob- 
jekts. 

Der Aufruf einer Methode eines Objekts wird 
davon beeinflußt, ob die Methode virtuell ist 
oder nicht. Wenn die Methode virtuell ist, muß 
die Adresse der Methode aus der Methoden- 
Sprungtabelle herausgesucht werden. (Im fol- 
genden Beispiel wird angenommen, daß das 
Objekt dynamisch ist.) 


aCube 


Zgr auf Speicher| — | Zgr auf Methodentabelle | — [ Zar auf Methoden | 
für Objekt 
Sie trat | [zur armen] 


(Anmerkung: Alle Objekte einer Klasse zeigen 
genau auf die gleiche Methoden-Sprungtabelle.) 

Für den Aufruf einer virtuellen Methode bei 
einem dynamischen Objekt ist folgendes not- 
wendig: 


LES DI, aCube ;Adresse des Objektspeichers 
PUSH ES ;Zeiger auf sich selbst pushen 
PUSH DI 


LES DI, ES:[D1] ;Adresse 
CALL FAR ES: [DI+Offset_des_Methodenvektors] 


Es ist wieder zu beachten, daß selbst bei virtu- 
ellen Methoden und dynamischen Objekten zur 
Laufzeit keine »Suche« notwendig ist. Bereits bei 
der Kompilierung kann der Compiler den Offset 
der gewünschten Methode feststellen und den 
entsprechenden Code erzeugen. 

Beim Aufruf einer virtuellen Methode bei 
einem statischen Objekt gibt es einfach nur eine 
Ebene der Indirektion weniger: 


aCube | Zgr auf Methodentabelle | —> | Zgr auf Methodel 
Speicher für Objekt Zgr auf Methode? 


Unter der Voraussetztung, daß sich das stati- 
sche Objekt im Datensegment befindet: 


MOV DI, [aCubet0] ; Adresse der Sprungtabelle 


PUSH 05 ; Zeiger auf sich selbst pushen 
LEA AX, aCube 

PUSH AX 

CALL FAR [DI+Offset_des Methodenvektors] 


Der Aufruf einer nicht virtuellen Methode bei 
einem statischen Objekt ist einfach. Der Aufruf 
wird zu einem einfachen Prozeduraufruf: 


PUSH DS ; Zeiger auf sich selbst pushen 
LEA AX, aCube 
PUSH AX 


CALL Adresse_der Methode 


Ganz ohne Frage beeinflussen die Objekt-Allo- 
kierungs-Strategie (statisch oder dynamisch) und 
die Methoden-Zugriffs-Strategie (virtuell oder 
nicht) die Performance des kompilierten Codes. 
Da leistungsfähige Anwendungen dazu tendie- 
ren, dynamische Allokierung und virtuelle 
Methoden zu verwenden, müßte die Perfor- 
mance objektorientierter Anwendungen theore- 
tisch schlechter sein, als die traditioneller An- 
wendungen. In der Praxis ist die Performance je- 
doch nur selten ein Thema. C++ und objektori- 
entierte Erweiterungen von Pascal bieten eine 
gute Mischung traditioneller und objektorientier- 
ter Techniken. Dadurch kann der Benutzer eine 
klare Trennlinie ziehen, wo objektorientierte und 
wo traditionelle Techniken eingesetzt werden. 
Typischerweise werden objektorientierte Techni- 
ken für die Erledigung von Dingen auf überge- 
ordneter Ebene eingesetzt, wie: 


« Benutzerschnittstellen, 

« Gerätesimulation, 

« komplexe Datenstrukturen, 
« grafische Objekte. 


Diese Dinge arbeiten zumeist nur mit »Benut- 
zergeschwindigkeit«. (Die Anlage eines Fensters 
braucht nur so schnell zu arbeiten, wie der 
Benutzer Fenster anlegen kann, das heißt für 
einen Computer nicht besonders schnell.) 

Die traditionellen Techniken werden für 
systemnähere Operationen verwendet, die einen 
so geringen Overhead wie möglich erfordern. 

Die Performance von C++ und objektorien- 
tierten Pascal-Versionen sollte nur mit »reinen« 
objektorientierten Systemen wie SmallTalk und 
Actor verglichen werden, in denen selbst Daten 
auf niedriger Ebene (Konstanten, Integer, 
Strings, Arrays usw.) als Objekte implementiert 
sind. 


M-S-B-K Hamburg 


ee 
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Zusammenfassung 


Turbo Pascal 5.5 bietet einige Dinge, die Quick- 
Pascal 1.0 nicht hat. Die wichtigsten sind: 

1. statisch allokierte Objekte und 

2. nicht virtuelle Methoden. 

Dadurch werden Perfomance-Vorteile auf 
Kosten anderer Dinge erzielt: Der Verlust von 
Daten- oder Stackspeicher im Fall statisch allo- 
kierter Objekte oder der Verlust der Wiederver- 
wendbarkeit von Code im Fall der nicht virtuel- 
len Methoden. In der Praxis sieht es so aus, daß 
nicht triviale, objektorientierte Programme zu- 
meist virtuelle Methoden deklarieren und viele 
dynamisch allokierte Objekte verwenden. Die 
QuickPascal-Programmierumgebung wurde in 
QuickPascal geschrieben und macht ausgiebigen 
Gebrauch von seinen objektorientierten Möglich- 
keiten. Die Performance dynamischer Objekte 
und virtueller Methoden war also ein wichtiges 
Thema bei der Entwicklung. 

Der Einsatz von Konstruktoren und Destrukto- 
ren in Turbo Pascal 5.5 ist schlecht gelöst. Er- 
stens wird zwar die Terminologie von C++ ver- 
wendet, die Implementierung ist jedoch wesent- 
lich weniger leistungsfähig. Insbesondere das 
Fehlen des automatischen Aufrufs bei der Anlage 
eines Objekts und das Löschen (besonders bei 
statischen Objekten) ist enttäuschend. Zum zwei- 
ten scheint die Notwendigkeit von Konstruktoren 
und Destruktoren in Turbo Pascal ein Ergebnis 
einer schwachen Implementierung zu sein, weni- 
ger der Wunsch, neue Funktionalität zu bieten. 
Turbo Pascal 5.5 benötigt Konstruktoren und De- 
struktoren um: 

1. die virtuelle Methodentabelle einzurichten und 
2. den »dispose«-Aufruf über die Objektgröße zu 
informieren. 

QuickPascal erzielt diese beiden Punkte ohne 
zusätzliche konzeptionelle Belastungen. Virtuelle 
Methoden-Tabellen werden automatisch bei der 
Allokierung eines Objekts eingerichtet. Die 
»dispose«-Funktion weiß automatisch die richtige 
Größe eines Objekts. 
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Lieferengpässe 
beim Ashton 
Tate/Microsoft 
SQL-Server 
beseitigt 


achdem die erste Auflage 

der seit Mai von Ashton 
Tate ausgelieferten Endanwen- 
der-Version des Ashton 
Tate/Microsoft SQL-Servers 
überraschend schnell vergriffen 
war, konnten die entstandenen 
Lieferengpässe nach Mitteilung 
von Ashton Tate jetzt behoben 
werden. Dieses Produkt, das Er- 
gebnis einer gemeinsamen Ent- 
wicklung von Microsoft, Sybase 
und Ashton Tate, ist ab sofort 
zum Preis von DM 5.950,- zu- 
züglich Mehrwertsteuer wieder 
lieferbar. 

Mit dem SQL-Server bieten 
Microsoft und Ashton Tate ein 
relationales Datenbank-Server- 
Programm für lokale Netzwerke. 
Es arbeitet auf der Basis der Cli- 
ent-Server-Architektur, die MS- 
DOS, MS O0S/2 und Microsoft 
Windows Applikationen einen 
Zugriff auf Multiuser-Daten- 
bank-Dienstleistungen im ge- 
samten Netzwerk ermöglicht. 
Der SQL-Server stellt einen er- 
heblichen Fortschritt für die 
Workstation-orientierte Daten- 
verarbeitung dar. Mit einer brei- 
ten Palette von kommerziellen 
Front-end-Programmen können 
komplexe transaktionsorientierte 
Datenverarbeitungs-Systeme 
realisiert werden. Der SQL-Ser- 
ver hat eine offene Software- 
Plattform für eine breite Palette 
von PC-gestützten Programmen 
(z.B. dBase IV, Tabellenkalkula- 
tionen u.a.) geschaffen. Auf PC- 
LAN-Basis wird damit eine ganz 
neue Klasse von Datenbank- 
lösungen möglich, die es bisher 
nur auf Mini- oder Großcompu- 
tern gab. 

Der Auslieferung des Endan- 
wender-Produktes ging ein sehr 
erfolgreiches Aktions-Programm 
voran, in dessen Rahmen 
Microsoft und Ashton Tate mehr 
als 1.000 SQL-Server Network 
Developer's Kits (NDK) an Soft- 
ware-Entwickler lieferten. 


Weit verbreitete Programme, 
die derzeit an den SQL-Server 
angepaßt werden, sind zum Bei- 
spiel DataEase, Advanced Reve- 
lation, PC Focus, Paradox, Lotus 
1-2-3, dBase IV, Microsoft Excel 
und viele weitere Produkte. Ap- 
plikations-Entwickler können 
darüber hinaus Standard-Pro- 
grammiersprachen wie C und 
Cobol nutzen, um Applikationen 
für den SQL-Server zu entwic- 
keln. 

Voraussetzung für den Betrieb 
des SQL-Servers ist die Installa- 
tion von MS OS/2. Die Netz- 
werk-Unterstützung umfaßt 
Netzwerk-Software wie 3Com 
3+Open, IBM LAN-Server, Un- 
germann-Bass Net/One sowie 
MS 05/2 LAN-Manager. Zukünf- 
tig wird der SQL-Server auch mit 


- anderen verbreiteten PC-Netz- 


werken, einschließlich solchen 
auf Basis des Microsoft LAN- 
Manager und auf Novell Net- 
Ware arbeiten. 

Lizenzinhaber des SQL-Server 
Network Developer's Kits haben 
die Möglichkeit, die SQL 
Endanwender-Version zu einem 
günstigen Upgrade-Preis von DM 
990,- zzgl. MwSt. bei Ashton 
Tate zu beziehen. 


Neue Version 2.1 
der MS-DOS CD- 
ROM-Extension 
unterstützt 
Interleaved-Audio 


uf der vierten CD-ROM- 

Konferenz in Anaheim, 
Kalifornien, hat Microsoft kürz- 
lich die Version 2.1 der MS-DOS 
CD-ROM-Extension vorgestellt. 
Die neue Version unterstützt die 
Möglichkeit, neben optischen 
auch akustische Informationen 
(Interleaved-Audio) in CD-ROM 
Extended Architecture (XA) Ap- 
plikationen zu verarbeiten. Wei- 
tere Merkmale sind die Unter- 
stützung der Betriebssystem- 
Version MS-DOS 4.0 sowie die 
Möglichkeit, CD-ROM-Lauf- 
werke in einem lokalen Netz- 
werk einzusetzen. 

Vor dem Hintergrund, daß 

MS-DOS 4.0 in immer stärkerem 


Maße durch PC-Hersteller aus- 
geliefert wird, bedeutet die Un- 
terstützung für diese Betriebs- 
system-Version, daß Software- 
Entwickler nun damit beginnen 
können, MS-DOS- und Microsoft 
Windows-Applikationen zu er- 
stellen, die sich durch eine ver- 
besserte Audiotechnik auszeich- 
nen. Die Verfügbarkeit einer 
Standard-Schnittstelle zu CD- 
ROM-XA-Interleaved-Files und 
Compressed Audio ist ein großer 
Schritt nach vorne. Es sind nun 
komplette Multimedia-Software- 
Applikationen möglich, die eine 
wesentliche Rolle bei der zu- 
künftigen PC-Datenverarbeitung 
spielen werden. 

Für den Einsatz der MS-DOS 
CD-ROM-Extension ist ein PC 
mit MS-DOS Betriebssystem, 
Version 3.1 oder höher, erfor- 
derlich. Die MS-DOS CD-ROM 
Extension, Version 2.1, wird CD- 
ROM-Laufwerk-Herstellern im 
Rahmen von Lizenzverträgen 
durch Microsoft ab sofort zur 
Verfügung gestellt. 


Microsoft Excel 
unterstützt IBM 
OfficeVision/2 


icrosoft kündigte die Ent- 

wicklung von Applika- 
tionssoftware zur Integration in 
das neue Paket IBM OfficeVisi- 
on/2 an. Anläßlich der IBM-Vor- 
stellung von OfficeVision/2 gab 
Microsoft einen Ausblick auf die 
zukünftige Presentation Mana- 
ger Version des weitverbreiteten 
Tabellenkalkulations-Programms 
Microsoft Excel. Diese Version 
wird, so das Unternehmen, die 
erste Applikationssoftware von 
Microsoft sein, die die Vorteile 
von MS 0S/2 1.1 und 1.2 nutzt. 
Microsoft plant, eine komplette 
Reihe von Applikationen mit der 
grafischen Bedieneroberfläche 
des Presentation Managers her- 
auszubringen. 

Nach den Worten von Chri- 
stian Wedell, Geschäftsführer 
der deutschen Microsoft GmbH, 
entspricht Microsoft damit einer 
Forderung der Anwender, »die 
bei allen eingesetzten Applika- 
tionen eine einheitliche 


Bedieneroberfläche und die 
Übereinstimmung zum SAA- 
Standard der IBM wünschen«. 

Excel ist das führende Tabel- 
lenkalkulations-Programm für 
grafikorientierte Betriebssystem- 
umgebungen. Microsoft Excel 
unter Windows und für den 
Apple Macintosh sind bereits 
verfügbar. Die Version für MS 
0S/2 1.1 und MS OS/2 1.2 soll 
noch im Laufe dieses Jahres 
ausgeliefert werden. Das Pro- 
gramm umfaßt leistungsfähige 
Analyse-Werkzeuge sowie Funk- 
tionen zur Organisation und 
Präsentation von Daten. 

Microsoft Excel kann sowohl 
Informationen von IBM Office- 
Vision/2 empfangen als auch 
dorthin senden. Mit Hilfe einer 
Dialog-Box, die in der leistungs- 
fähigen Makro-Programmier- 
sprache von Microsoft Excel er- 
stellt wurde, hat der Anwender 
die Möglichkeit, einen Befehl 
über die Mail-Funktion von 
OfficeVision/2 an eine andere 
Workstation zu schicken. Ist dort 
ebenfalls Microsoft Excel für den 
Presentation Manager installiert, 
nimmt dieses Programm den Be- 
fehl entgegen, führt ihn aus und 
schickt mittels OfficeVision/2 
eine Bestätigung an den Absen- 
der. Diese Art der Integration 
wird möglich, da Microsoft Excel 
die Service-Funktionen von 
OfficeVision/2 und die Vorteile 
von IBM Personal System/2 
unter der erweiterten Version 
des Betriebssystems MS 0S/2 
nutzt. 


Deutsche Bundes- 
post entscheidet 
sich für MS OS/2 


inen entscheidenden 

Durchbruch konnte der 
neue Betriebssystemstandard MS 
0S/2 von Microsoft und IBM 
nun auch im Bereich der öffent- 
lichen Verwaltung erzielen. 
Nach ersten Erfolgen dieses MS- 
DOS Nachfolgesystems in der 
Privatindustrie, hat sich nun der 
größte deutsche Arbeitgeber, die 
Deutsche Bundespost, für MS 
OS/2 entschieden. Für die um- 


fassende Modernisierung und 
Elektronisierung ihrer Dienstlei- 
stungen sollen sämtliche Schal- 
ter in allen bundesdeutschen 
Postämtern mit MS OS/2-Perso- 
nalcomputern ausgerüstet wer- 
den. Alle schalterüblichen 
Dienstleistungen werden dort in 
EPOS (Electronic Post Office 
System) zusammengefaßt. Der 
Lieferant von Hard- und Soft- 
ware wird zur Zeit im Rahmen 
einer öffentlichen Ausschreibung 
des Posttechnischen Zentral- 
amtes (PTZ) gesucht. 


Derzeit besteht EPOS noch 
aus 4.000 Nixdorf PCs mit 
80186er Intel-Prozessor und 
einem auf MS-DOS basierenden 
Betriebssystem. Eine einheitliche 
Bedieneroberfläche wurde vom 
PTZ vorgegeben und wird auch 
unter MS OS/2 beibehalten. Es 
handelt sich um eine geschlos- 
sene Anwendung, bei der der 
Schalterbeamte keinen Zugriff 
auf das Betriebssystem hat. Ins- 
gesamt werden 280 unter- 
schiedliche Vorgänge - von der 
Postsparkassenbuch-Verwaltung 
über Ein- und Auszahlungen bis 
hin zum Verkauf von Briefmar- 
ken und Postkarten — über die 
EPOS-Computer abgewickelt. 
Das Kassenbuch wurde durch 
persönliche »Kassen-Disketten« 
der einzelnen Schalterbeamten 
ersetzt. 

Das unter Microfocus Cobol 
entwickelte EPOS-Programm ist 
rund 2 Mbyte groß, beansprucht 
jedoch derzeit durch Datenswit- 
ching nur 912 Kbyte Hauptspei- 
cher. Die Speicherbegrenzung 
von MS-DOS war daher auch 
das Hauptargument für das PTZ, 
auf MS OS/2 umzusteigen. 
Anette Klüber-Meyer, Referats- 
leiterin für Hard- und 
Grundsoftware für Endgeräte 
beim PTZ: »EPOS ist durch die 
hohen Anforderungen an An- 
wenderfreundlichkeit und 
Datensicherheit und durch die 


hohe Komplexität heute an die 
Grenzen des Betriebssystems 
MS-DOS gestoßen. Wir haben 
uns daher nach einem neuen, 
allgemein anerkannten und lei- 
stungsfähigen Standard umge- 
sehen. MS 0S/2 bzw. IBM BS/2 
entspricht hier voll unseren heu- 
tigen und zukünftigen Anforde- 
rungen. Wir werden die verbes- 
serte Speicherverwaltung und 
die Multitaskingfähigkeiten nut- 
zen.« 

In der ersten Stufe der Im- 
plementierung wird das EPOS- 
Programm strukturell unverän- 
dert auf MS OS/2 portiert. Erste 
Portierungsversuche mit dem 
Cobol OS/2-Compiler von 
Microfocus und Microsoft waren 
erfolgreich. In dieser Projekt- 
phase wird lediglich die gegen- 
über MS-DOS verbesserte Spei- 
cherverwaltung benutzt. Stan- 
dardrechner im EPOS sollen 
Industriestandard-PCs mit dem 
80386-Prozessor von Intel und 4 
Mbyte Hauptspeicher werden. 
Der vergrößerte Arbeitsspeicher 
wird die Performance der EPOS- 
Software wesentlich erhöhen. 

In der zweiten Projektphase 
findet die Integration von Daten- 
fernübertragungsmöglichkeiten 
in EPOS statt. Unter MS 05/2 
werden über Bildschirmtext im 
Hintergrund z.B. Deckungsab- 
fragen im Postgirodienst abge- 
wickelt. 

In der dritten Ausbauphase 
schließlich sollen weitere Multi- 
taskingmöglichkeiten von MS 
0S/2 für EPOS nutzbar gemacht 
werden. MS 0S/2 ermöglicht die 
Effektivierung der EPOS-Soft- 
ware durch seine vielfachen 
Multitasking-Möglichkeiten. 
Weitere Ausbaumöglichkeiten — 
etwa die Integration in ISDN — 
werden als Optionen für die Zu- 
kunft beim PTZ derzeit disku- 
tiert. 

Microsoft verspricht sich von 
der Entscheidung der Deutschen 
Bundespost für MS OS/2 eine 
deutliche Stärkung dieses neuen 
Betriebssystemstandards. Chri- 
stian Wedell, Geschäftsführer 
der deutschen Microsoft GmbH: 
»Dies ist weltweit die bislang 
stückzahlmäßig größte Aus- 
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Projekt. Wir betrachten die Ent- 
scheidung des größten bundes- 
deutschen Arbeitgebers und des 
größten öffentlichen Dienstlei- 
sters für MS OS/2 als wegwei- 
send. Neben der Industrie ent- 
scheiden sich nun auch immer 
mehr öffentliche Auftraggeber 
für MS OS/2 als den derzeit 
modernsten PC-Betriebs- 
systemstandard.« 


Kentucky Fried 
Chicken »kocht« 
mit MS OS/2 


ie amerikanische Fast-Food- 

Kette Kentucky Fried 
Chicken, ein Unternehmen der 
weltweiten Pepsico Inc., sieht in 
der »computerunterstützten 
intelligenten Küche« das richtige 
Rezept für einen schnelleren 
Service und bessere Profitabili- 
tät. Als »Zutat« setzt das Unter- 
nemen jetzt auf das Betriebs- 
system MS OS/2. 


Um einen optimalen Be- 
triebsablauf zu ermöglichen und 
die Restaurant-Manager bei 
ihrer Disposition zu unterstüt- 
zen, installiert Kentucky Fried 
Chicken ein neuartiges Netzwerk 
von Personalcomputern und 
Kassenterminals, das außerdem 
den Autoschalter-Service um 30 
Prozent beschleunigt. Der Start 
des Projekts erfolgt demnächst 
in drei Standorten in Louisville. 

Neben der Material- und Zeit- 
Disposition liefern die PCs auch 
Informationen zu anderen Berei- 
chen der Betriebsführung, wie 
Arbeitsplanung und Personal- 
Koordination, Absatzprognosen 
und aktuelle Preisdaten. Die 
Anwendung wird auf dem NCR 
2760 Food Service System reali- 
siert, das PCs umfaßt, die unter 
dem Multitasking-Betriebs- 
systemstandard MS OS/2 von 
Microsoft laufen. In den USA 
werden mehr als 1.200 Restau- 
rants mit dem neuen System 
ausgestattet. 


Microsoft stellt 
Version 1.2 des 
Betriebssystems 
MS OS/2 mit Pre- 
sentation Manager 
vor 


it der neuen Version 1.2 

des Betriebssystems 
MS 05/2 bietet Microsoft jetzt 
ein Dateisystem mit noch besse- 
ren Leistungsmerkmalen, ein- 
schließlich einer verbesserten 
Presentation Manager-Ober- 
fläche. Die zusätzlichen Funk- 
tionen und Neuerungen in MS 
0S/2 Version 1.2, die ab Sep- 
tember 1989 verfügbar sein 
wird, reflektieren die von An- 
wendern und Entwicklern ge- 
äußerten Forderungen an den 
neuen Betriebssystemstandard 
MS OS/2. Mit der Auslieferung 
von bedeutenden MS OS/2 Ap- 
plikationen und der verbesserten 
Version 1.2 schafft Microsoft die 
Grundlage für eine erfolgreiche 
Weiterentwicklung im Jahre 
1990. 

MS 05/2 Version 1.2 beinhal- 
tet ein neues Dateisystem, das 
die heute vorhandenen techni- 
schen Möglichkeiten zur Verbes- 
serung der System-Antwortzeit 
und der Gesamt-Systemleistung 
nutzt. Diese neue Technik ist 
zudem die Basis für weitere 
Dateisystem-Funktionen, die in 
späteren Versionen von MS 
0S/2 verfügbar sein werden. 
Der größte Nutzen aus dem 
neuen Dateisystem ergibt sich 
bei Datenbank- und Server-Ap- 
plikationen, wo sehr viele Plat- 
tenzugriffe stattfinden und 
große Mengen von Daten ge- 
schrieben und gelesen werden. 
Das neue Dateisystem ist des- 
halb in erster Linie für den Ein- 
satz auf Festplatten ausgelegt. 
MS OS/2, Version 1.2, kann bis- 
herige MS-DOS Dateisysteme 
ebenso unterstützen wie das 
neue Dateisystem, so daß die 
Kompatibilität zwischen MS 
0S/2 und MS-DOS hinsichtlich 
der auf den Systemen laufenden 
Applikationen gewahrt bleibt. 
MS 0S/2 1.2 ist aufwärtskompa- 
tibel zur Version 1.1. 


Software-Entwickler haben 
daher die Möglichkeit, eine 
einzige Programmversion zu 
erstellen, die auf beiden 
Betriebssystemen läuft und 
trotzdem alle Vorteile der in MS 
0S/2 1.2 verfügbaren 
Funktionen ausnutzt. 

Für Borland International, 
Entwickler des Programms Side- 
Kick, der ersten Applikation für 
MS 05/2 mit Presentation 
Manager, betont Brad Silver- 
berg, Vice President für For- 
schung und Entwicklung, »daß 
zukünftige Versionen der Bor- 
land-Produkte für MS 0S/2 die 
speziellen Funktionen in MS 
0S/2 1.2 unterstützen werden«. 

Die Verbesserungen der Pre- 
sentation Manager-Oberfläche in 
MS 0S/2 1.2 beinhalten nun 
direkte Manipulationsmöglich- 
keiten von Systemelementen, 
wie das Kopieren von Dateien 
durch entsprechendes Verschie- 
ben der Symbole mit der Maus 
und den zusätzlichen Einsatz 
von Symbolen zur Darstellung 
von Informationen. Neu ist auch 
ein Systemeditor, der die Pre- 
sentation Manager-Schnittstelle 
in ähnlicher Weise nutzt wie der 
Notepad-Texteditor in Microsoft 
Windows. Hinzugekommen sind 
ferner eine Dual-Boot-Funktion 
für MS-DOS und MS 0S/2 sowie 
ein PostScript-Gerätetreiber. Die 
MS-DOS Kompatibilitätsbox, die 
den Ablauf von MS-DOS Appli- 
kationen auf einem MS OS/2-PC 
ermöglicht, hat in der Version 
1.2 einen größeren Adreßraum. 
Außerdem können MS-DOS Pro- 
gramme auch direkt aus der Pre- 
sentation Manager-Oberfläche 
gestartet werden. Die Hand- 
habung wird dadurch wesentlich 
vereinfacht. 


IBM OfficeVision/2 
nutzt Microsoft 
LAN-Manager 
Technik 


nläßlich der SAA Office- 

Vision-Ankündigung gab 
IBM bekannt, daß der Einsatz 
von Microsoft Netzwerktechnik 
in drei Bereichen geplant ist: Die 
erweiterte Version des Betriebs- 
systems IBM OS/2 1.2 (in der 
BRD BS/2 1.2) wird 13 Katego- 
rien der LAN-APIs (Application 
Programming Interfaces) unter- 
stützen, die kompatibel sind mit 
den entsprechenden Microsoft 
LAN-Manager API-Kategorien. 
Außerdem nutzt IBM in dieser 
Produktlinie den IBM LAN Re- 
quester, Version 1.2, der auf der 
LAN-Manager-Technik basiert. 
Darüber hinaus kündigte IBM 
die Unterstützung der Version 
1.2 für ausgewählte Ethernet- 
Adapter an, die entsprechend 
der Microsoft/3Com NDIS 
(Network Driver Interface Speci- 
fications) geschrieben sind. 

Die IBM-Ankündigungen stär- 
ken die Position des Microsoft 
LAN-Managers in zwei Schlüs- 
selbereichen: der Entwicklung 
von Netzwerk-Applikationen 
und der Verfügbarkeit eines 
standardisierten LAN-Adapter- 
karten-Interfaces für Netzwerk- 
protokoll-Software. Christian 
Wedell, Geschäftsführer der 
deutschen Microsoft GmbH, be- 
tonte, daß für unabhängige 
Software-Entwickler, Endan- 
wender und auch für Hardware- 
Hersteller »das Leben nun ein 
wenig leichter gemacht wird«. In 
derselben Weise, wie NetBIOS 
die Entwicklung der ersten 
Netzwerk-Applikationen geför- 
dert hat, werden die LAN-Mana- 
ger APIs die Erstellung der näch- 
sten Generation von echten ver- 
teilten Applikationen unterstüt- 
zen. 

Die Verwendung der 
Microsoft LAN-Manager-Technik 
in SAA OfficeVision bietet dem 
Anwender eine freie Wahl bei 
der Netzwerk-Umgebung. Ar- 
beitsplatz-Computer, auf denen 
SAA OfficeVision-Software unter 


IBM 05/2 1.2 läuft, können Ser- 
ver-Ressourcen nutzen, die unter 
dem Microsoft LAN-Manager 
laufen. Außerdem wird Arbeits- 
platz-Computern unter dem 
LAN-Manager der Zugriff auf 
den IBM LAN Server ermöglicht. 

Die von IBM angekündigte 
LAN API-Unterstützung für OS/2 
1.2, in Verbindung mit der be- 
reits vorhandenen Unterstüt- 
zung von Named Pipes hat zur 
Folge, daß ein Satz von 89 APIs 
aus 13 Kategorien des Microsoft 
LAN-Managers verfügbar sein 
wird. Die LAN-Manager APIs 
bieten für die Entwickler von 
Applikationen leistungsfähige 
Funktionen: So kann z.B. die 
Interprozeß-Kommunikation 
zwischen Programmen im ge- 
samten Netzwerk erfolgen. Da- 
mit ist die Entwicklung von ver- 
teilten Applikationen möglich. 
Außerdem sind Ressourcen-Zu- 
griffsanfragen nach Servern oder 
Druckern sowie Netzwerk-Ver- 
waltungsfunktionen, wie fernge- 
steuerte Operationen und die 
Überwachung von wichtigen Be- 
triebszuständen auf dem Netz- 
werk verfügbar. 

Mehr als 100 unabhängige 
Software-Hersteller und -Ent- 
wickler erarbeiten derzeit Appli- 
kationen, die LAN-Manager APIs 
nutzen. Die Implementierung 
eines Standardsatzes von APls in 
05/2 1.2 und im Microsoft LAN- 
Manager bedeutet, daß Ent- 
wickler von Netzwerk-Applika- 
tionen ihre Software nur gemäß 
einem einzigen Satz von Inter- 
face-Spezifikationen auslegen 
brauchen, um diese Software in 
IBM LAN Server- und Microsoft 
LAN-Manager Netzwerken ein- 
zusetzen. 

Die IBM-Ankündigung fand in 
der gesamten Software-Branche 
eine breite Resonanz. Unter- 
nehmen wie Ashton-Tate, Reve- 
lation Technology, Saros Corpo- 
ration und andere begrüßten die 
einheitlichen API-Spezifikatio- 
nen und kündigten für ihre Pro- 
dukte deren Unterstützung an. 
IBM selbst erwarb eine Lizenz 
für die Microsoft/3Com LAN- 
Manager NDIS. Mehr als 35 Her- 
steller haben bisher die NDIS 
unterzeichnet. Darunter Firmen 


wie AT&T, NCR, Hewlett- 
Packard, 3Com, Ungermann- 
Bass, Proteon, Interlan, Stan- 
dard Microsystems, Intel, 
Western Digital, Retix, FTP 
Software, Madge Computers 
Limited und Sytek Inc. Die Aus- 
richtung der Version 1.2 des Be- 
triebssystems OS/2 auf die LAN- 
Manager Schnittstellen-Spezifi- 
kationen (NDIS) gewährleistet, 
daß SNA-, NetBIOS- und Pro- 
gramme, die entsprechend dem 
IEEE 802.2-Programmier-Inter- 
face geschrieben worden sind, 
auch auf Ethernet-LANs laufen 
können. Die Verbin- 
dungsmöglichkeiten von Syste- 
men unterschiedlicher Hersteller 
werden damit erheblich verbes- 
sert. 


Microsoft gründet 
Multimedia Divi- 
sion 


D: Microsoft Corporation 
gab in diesen Tagen die 
Gründung einer Multimedia Di- 
vision bekannt, die sich aus- 
schließlich der Entwicklung und 
Vermarktung von Multimedia 
Software und Endanwender- 
Produkten widmen wird. 

Christian Wedell, Geschäfts- 
führer der Microsoft GmbH, 
München-Unterschleißheim, und 
verantwortlich für das Geschäft 
des führenden Software-Anbie- 
ters in der Bundesrepublik, 
Österreich, der Schweiz und 
Osteuropa: »Innerhalb der näch- 
sten Jahre muß man mit einem 
grundlegend neuen PC-Typus 
rechnen, der Hochgeschwindig- 
keitsprozessoren, hochauf- 
lösende Bildschirme und opti- 
sche Medien verbindet. Dieser 
Multimedia-PC wird sowohl den 
privaten wie auch den beruf- 
lichen Anwender ansprechen. 
Die neue Multimedia Division 
von Microsoft soll unsere Arbeit 
in diesem Bereich forcieren und 
unterstützen.« 

Geleitet wird die neue Divi- 
sion, die in zwei Gruppen unter- 
teilt ist, von Min Yee, Vizepräsi- 
dent von Microsoft. Geschäfts- 
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Group«, zuständig für Multi- 
media Software-Entwicklung 
und -Vermarktung, ist Rob Gla- 
ser, seit kurzem Marketing 
Director des Geschäftsbereichs 
Netzwerke. Der ehemals zu 
Microsoft Press gehörige CD- 
ROM Produktbereich wird um- 
benannt in »Multimedia Publis- 
hing Group« und unter Leitung 
von Susann Lammers verant- 
wortlich sein für die Entwick- 
lung und Vermarktung von 
Multimedia Endanwender-Pro- 
dukten, einschließlich der Pro- 
grammer's Library und Book- 
shelf. 


Microsoft Mäuse 
überspringen 2- 
Millionen-Hürde 


E.: neue Rekordmarke no- 
tierten in diesen Tagen die 
Microsoft Mäuse: In den vergan- 
genen 12 Monaten wurden über 
eine Million dieser beliebten 
Eingabehilfe, die vielfach als das 
»Original« bezeichnet wird, ver- 
kauft. Damit kletterte die Ge- 
samtzahl der im Markt befindli- 
chen Microsoft Mäuse auf über 
zwei Millionen Exemplare. Ein 
Ergebnis, das selbst Microsoft 
überraschte, da man vor Jahres- 
frist das Erreichen dieser Re- 
kordmarke erst gegen Ende 
1989 bzw. Anfang 1990 progno- 
stizierte. Hauptanteil mit über 
1,5 Mio. Stück an diesem Erfolg 
hat die im August 1987 einge- 
führte neue Microsoft Maus, die 
nicht nur durch ihr inzwischen 
vielfach preisgekröntes Design 
überzeugt, sondern vor allem 


auch durch Verschleißfreiheit 
und anwenderfreundliche Be- 
dienbarkeit. 

Die Microsoft Maus unter- 
stützt den Anwender bei der Be- 
nutzung einer leistungsfähigen 
und komfortablen grafischen 
Bedieneroberfläche. Der Ver- 
kaufserfolg der Microsoft be- 
zeugt denn auch die Durchset- 
zung grafischer Bedieneroberflä- 
chen. Weltweit werden heute 
bereits monatlich knapp 100.000 
Packungen des Standards 
Microsoft Windows verkauft. 
Nicht mitgerechnet sind hier die 
vielen Tausend Windows-Ver- 
sionen, die Hardware-Hersteller, 
wie zum Beispiel Schneider, 
Compaq und Siemens, direkt mit 
ihren Maschinen ausliefern. 


Netzwerktreiber- 
Interface- 
Spezifikation 


ie Netzwerktreiber-Inter- 

face-Spezifikation (NDIS) 
ist für Software-Entwickler ein 
Standard, auf dessen Basis sie 
Treiber für Netzwerk-Adapter 
und Kommunikations-Protokolle 
entwickeln können, die mit 
Microsoft LAN-Manager Soft- 
ware arbeiten. Darüber hinaus 
bietet die NDIS die Grundlage 
für den Protokoll-Manager, 
einen Konfigurations- und An- 
schlußtreiber. Microsoft und 
3Com haben die NDIS für MS- 
DOS und MS OS/2 erstmals im 
April 1988 veröffentlicht. Die 
derzeitige Version ist seit Mai 
1988 erhältlich. 

Die modulare NDIS-Architek- 
tur minimiert den Entwicklungs- 
Aufwand für flexibel einsetzbare 
Netzwerk-Adapter und -Proto- 
kolle; Installations-Abläufe wer- 
den vereinfacht. 

Treiber, die gemäß den in der 
NDIS definierten Schnittstellen 
geschrieben sind, arbeiten auch 
in Systemen mit anderen NDIS- 
Netzwerk- und Protokoll-Trei- 
bern. In der NDIS sind drei Klas- 
sen von Treibern spezifiziert, die 
die Unterstützung von verschie- 


denen Netzwerk-Adaptern und 
Protokollen vereinfachen: 

« NDIS-Netzwerk-Adaptertrei- 
ber mit Low-Level-Zugriff auf 
Netzwerk-Adapter 

* Protokoll-Treiber, die einen 
gesamten Ablauf, Transport, 
Netzwerk und »Data Link Proto- 
col Layer« umfassen, um einen 
Kommunikationsdienst auf 
höherer Ebene zu unterstützen. 
* Protokoll-Manager als ein 
spezieller Treiber, der einen 
Standard für die Lösung von 
Konfigurationsproblemen bildet 
und verschiedene Netzwerk-Ad- 
apter sowie Protokoll-Treiber 
einbinden kann. 

Seit der Veröffentlichung der 
derzeit gültigen NDIS-Version 
vom Mai 1988, wird dieser 
Standard von der Netzwerk- 
Branche auf breiter Basis unter- 
stützt. Zur Zeit sind mehr als 30 
NDIS-Treiber am Markt verfüg- 
bar. Weitere 117 Treiber sind in 
der Entwicklung bzw. im Kon- 
formitätstest. Diese Treiber wur- 
den für Netzwerk-Adapter von 
3COM, AT&T, EXCELAN, Gate- 
way Communications, Hewlett- 
Packard, IBM, Intel, INTERLAN, 
NCR, Proteon, Standard Micro- 
systems, Sytek, Ungermann- 
Bass, Western Digital und ande- 
ren Herstellern erstellt. 

Microsoft liefert zur Zeit das 
Netzwerktreiber-Entwicklungs- 
Kit (NDDK) zur Unterstützung 
der Entwickler von NDIS-Trei- 
bern aus. Das NDDK umfaßt alle 
Entwicklungswerkzeuge, die 
zum Erstellen von Treibern not- 
wendig sind. Ferner beeinhaltet 
das NDDK Muster-Quellcode für 
IBM-Token-Ring und Intel-PC- 
586-Ethernet-Adaptertreiber. 
Microsoft entwickelt darüber 
hinaus eine Netzwerktreiber- 
Programmbibliothek, um Trei- 
ber-Software auf breiter Basis zu 
erstellen. Die Bibliothek wird in 
den USA auf einer Vielzahl von 
»Electronic Bulletin Boards« ver- 
fügbar sein, so daß auch 
Endanwender NDIS-kompatible 
Netzwerk-Adapterkarten-Treiber 
kopieren und laden können. 

Alle Treiber der Microsoft 
LAN-Manager Netzwerktreiber- 
Bibliotheken sind von einem un- 
abhängigen NDIS-Testlabor auf 


Konformität geprüft worden. Sie 
werden immer paarweise gete- 
stet: sowohl für die MS-DOS- als 
auch für die MS OS/2-Umge- 
bung. Beide Treiber sind jeweils 
für dieselbe Netzwerk-Adapter- 
karte ausgelegt. 


Microsoft vergibt 
erste OEM-Lizenz 
für ROM-residentes 
MS-DOS an 
Emerson Radio 


icrosoft gab vor wenigen 

Tagen die Lizenzvergabe 
für eine spezielle ROM-residente 
MS-DOS Version für die von 
Emerson Radio Corp. kürzlich 
angekündigten Lowcost-PCs be- 
kannt. Damit ist Emerson der er- 
ste PC-Hersteller, an den Micro- 
soft dieses 1981 entwickelte 
Industriestandard-Betriebs- 
system in ROM-residenter Ver- 
sion lizensiert. Die Lizenzver- 
gabe an Hardware-Hersteller 
wie Emerson, die die Vorteile 
dieses Standard-Betriebssystems 
erkennen, eröffnet Microsoft 
neue Marktsegmente. 

Bei »ROM-residenter« Installa- 
tion wird das Betriebssystem di- 
rekt aus dem ROM (Read-Only- 
Memory) geladen und nicht 
über den »Umweg« von Diskette 
oder Festplatte gebootet. Dieses 
Verfahren bringt dem Anwender 
eine Reihe von Vorteilen: 

° Unmittelbar nach dem Ein- 
schalten des Computers er- 
scheint MS-DOS. Die üblichen 
Wartezeiten, die sich beim 
Laden des Betriebssystems erge- 
ben, entfallen. 

« Da das Betriebssystem bereits 
fest im Computersystem inte- 
griert ist, entfällt die nachträg- 
liche Installation. 

Das ROM-residente MS-DOS 
ist ein vollständiges Betriebs- 
system, das auf MS-DOS Version 
3.3 basiert. Zusätzlich werden 
Festplatten-Partitionen über 32 
Mbyte unterstützt. Die Emerson 
Radio Corp. wird das System mit 
ihren Modellen 800EC, 828 EC 
und 83836EC ausliefern. 


Microsoft und NCR 
erweitern Vertrag 
über Workgroup- 
Produkte 


CR gab die Erweiterung der 

Lizenzen für Microsofts 
Workgroup-Produkte auf den 
Microsoft SQL-Server und den 
Microsoft Communications Ser- 
ver bekannt. Damit ist NCR, als 
einer der weltweit führenden 
Anbieter von PCs, der erste 
Hardware-Hersteller, der die ge- 
samte Palette an Microsoft 
Workgroup-Produkten lizensiert. 

»Mit unserer Adaption der 
Client/Server-Architektur sind 
wir nun auf dem Markt die er- 
sten mit einer State-of-the-art- 
Netzwerktechnologie«, betont 
Tom Mays, Vizepräsident und 
General Manager der NCR Per- 
sonal Computing Division. »Die 
langfristige strategische Allianz 
mit Microsoft ermöglicht es uns, 
sehr früh mit neuen Produkten 
und Verbesserungen auf den 
Markt zu kommen.« 

Christian Wedell, Geschäfts- 
führer der Microsoft GmbH er- 
klärte hierzu gegenüber der 
Presse: »Für Microsoft ist die Li- 
zenzvereinbarung eine Bestäti- _ 
gung unserer Unternehmensstra- 
tegie, die einen umfassenden 
Service für MS-DOS und 
MS OS/2-Workgroups vorsieht 
und NCR jetzt die Möglichkeit 
eröffnet, Komplettlösungen 
anzubieten.« 

Die Microsoft OS/2 Work- 
group-Produktpalette setzt sich 
zusammen aus: 

e Microsoft LAN-Manager. Das 
erweiterte LAN-Betriebssystem 
läuft unter MS OS/2 auf dem 
Server und unterstützt MS-DOS, 
Microsoft Windows und 

MS OS/2-Workstations. Der 
Microsoft LAN-Manager bietet 
umfangreiche APIs (Application 
Programming Interface) zur Ent- 
wicklung verteilter Applika- 
tionen, fortschrittliche Fehler- 
schutz-Möglichkeiten sowie lei- 
stungsfähige Netzwerk-Verwal- 
tungs-Werkzeuge. Der LAN- 
Manager wurde von führenden 
Systemanbietern, Netzwerkher- 


stellern und Softwareentwick- 
lern als Standard-Netzwerk- 
Plattform für PC-LANs ange- 
nommen. 

e Microsoft SQL-Server. Ein 
Hochleistungs-Datenbank-Server 
für lokale Netzwerke. Er bietet 
eine Basis für transaktionsorien- 
tierte Applikationen, Tabellen- 
kalkulationen u.a., die bisher auf 
Großcomputern implementiert 
sind. Der Microsoft SQL-Server 
arbeitet auf MS OS/2 Servern 
und besitzt Fähigkeiten, die mit 
Minicomputern und Mainfraim 
RDBMs vergleichbar sind. Appli- 
kationen wie dBASE IV, Lotus 
1-2-3, Microsoft Excel und Para- 
dox werden unterstützt. 

®e Microsoft Communications 
Server. Er erweitert die An- 
schlußmöglichkeiten von PCs 
und LANs hin zu Wide Area Net- 
works und bietet den Benutzern 
einen flexiblen Zugriff auf IBM 
SNA-Netzwerke. Der Microsoft 
Communications Server bietet 
3270-Terminal- und Drucker- 
emulation sowie Datentransfer, 
APPC (advanced program to 
programm communication), 
sowie weitere Standard-Pro- 
grammierschnittstellen und 
asynchrone Terminal-Emulation 
und Datentransfer. 


Microsoft baut 
Marktführerschaft 
weiter aus 


hre führende Position am 

weltweiten PC-Softwaremarkt 
weiter ausbauen konnte die 
Microsoft Corporation, Red- 
mond/USA, die im zurückliegen- 
den Geschäftsjahr (zum 30.6.) 
ihren Umsatz von 590,8 Mio US- 
Dollar auf 803,5 Mio US-Dollar 
(+ 36%) ausbaute. Im gleichen 
Zeitraum wuchs der Gewinn 
(nach Steuern) um 39% von 
123,9 Mio US-Dollar auf 170,5 
Mio US-Dollar. 

Noch rasanter als die »Mutter« 
wuchs in den letzten 12 Mona- 
ten die deutsche Vertriebsgesell- 
schaft, die Microsoft GmbH, 
Unterschleißheim-München, 
deren Umsatz von 92 Mio DM 


auf 140 Mio DM (+ 53%) klet- Software 
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terte. Hauptumsatzträger der 
bundesdeutschen Vertriebsge- 
sellschaft sind neben den Stan- 
dardbetriebssystemen wie MS- 
DOS und MS OS/2 die von 
Microsoft entwickelten zahlrei- 
chen professionellen Program- 
miersprachen sowie Ap- 
plikationssoftware. Standard- 
anwendungen wie das Tabellen- 
kalkulationsprogramm Multi- 
plan, das Zahlenmanagement- 
programm Excel und das Text- 
verarbeitungsprogramm Word 
halten heute bereits einen Anteil 
von 65% am GmbH-Umsatz. Mit 
Word bietet Microsoft das meist- 
verkaufte deutschsprachige PC- 
Programm überhaupt an. Mit 
den Programmen Multiplan und 
dem neuen Excel für die grafi- 
sche Bedieneroberfläche Win- 
dows konnte Microsoft im ver- 
gangenen Jahr in der Bundes- 
republik auch im hart umkämpf- 
ten Tabellenkalkulationsmarkt 
die Spitze einnehmen. 

Christian Wedell, Geschäfts- 
führer der Microsoft GmbH, er- 
wartet im laufenden Geschäfts- 
jahr weitere Wachstumsimpulse, 
die vor allem auch von dem 
Managementprogramm Excel für 
den neuen Oberflächenstandard 
Windows ausgehen werden. 
Schon heute verkauft Microsoft 
weltweit monatlich knapp 
100.000 Windows-»Pakete«. 


Umfang des 
Verfahrens Apple 
gegen Microsoft 
stark eingegrenzt 


m Verfahren Apple gegen 

Microsoft und Hewlett 
Packard hat der US-Bundesrich- 
ter W.W. Schwarzer eine Ent- 
scheidung getroffen, die den 
Umfang des Verfahrens erheb- 
lich einschränkt. 

William H. Neukom, Vizeprä- 
sident und zuständig für die 
rechtlichen und unternehmeri- 
schen Belange der Microsoft 
Corp.: »Wir sind über diesen 
Richterspruch äußerst erfreut. 
Von 189 behaupteten Copyright- 
Verletzungen sind nach Auffas- 
sung des Gerichts 179 Punkte 


von dem zwischen Apple und 
Microsoft 1985 geschlossenen 
Vertrag gedeckt. Sie sind nicht 
mehr Prozeßgegenstand. Die 
verbliebenen 10 Punkte bezie- 
hen sich ausschließlich auf die 
Benutzung überlappender 
Hauptapplikationsfenster und 
gewisser Charakteristika von 
Sinnbildern in Windows 2.03. 
Die jetzt vorliegende Eingren- 
zung des Verfahrens bringt uns 
einer Lösung des Problems einen 
großen Schritt näher.« 

In der jüngsten Entscheidung 
wurden folgende Feststellungen 
getroffen: 

1. Die Verwendung von visuel- 
len Darstellungselementen aus 
Windows 1.0 und den genann- 
ten Applikationen in Windows 
2.03 wird von dem Lizenzab- 
kommen zwischen Apple und 
Microsoft abgedeckt. 

2. Die in Windows 2.03 ver- 
wendeten visuellen Darstel- 
lungselemente sind in Windows 
1.0 und den genannten Applika- 
tionen enthalten, mit Ausnahme 
derjenigen, die sich auf die Be- 
nutzung von überlappenden 
Hauptapplikationsfenstern be- 
ziehen — im Gegensatz zu ge- 
kachelten Hauptapplikationsfen- 
stern - und mit Ausnahme von 
spezifischen Änderungen im 
Erscheinungsbild und der Hand- 
habung von Ikonen. 

3. Microsoft und ihr Lizenz- 
nehmer Hewlett Packard haben 
ein Anrecht auf ein Teilurteil 
über Apples Klage auf Rechts- 
verletzung insoweit die Klage 
auf der Verwendung von visuel- 
len Darstellungselementen aus 
Windows 1.0 und den genann- 
ten Applikationen in Windows 
2.03 und NewWave basiert. 

Microsoft geht davon aus, daß 
sich das Gericht und die Parteien 
in der nächsten Prozeßphase 
damit befassen werden, ob die 
in diesem Fall noch zu behan- 
delnden visuellen Darstellungs- 
elemente originale oder schütz- 
bare Elemente oder in der Li- 
zenzvereinbarung von 1985 be- 
inhaltet sind. 

In der Klage, die am 17. März 
1988 im US District Court for 
the Northern District of Califor- 
nia eingereicht wurde, vertritt 


Apple die Ansicht, Microsoft 
habe in Microsoft Windows 2.03 
audiovisuelle Urheberrechte von 
Apple verletzt. Microsoft dage- 
gen verweist auf das Lizenzab- 
kommen von 1985 und betont, 
keine schützbaren Interessen 
von Apple verletzt zu haben. 


Microsoft liefert 
neue Version 5.0 
des schnellen PC 
Fortran Compilers 
aus - kompatibel 
zur VAX- und IBM- 
Syntax 


icrosoft hat in diesen 

Tagen mit der Ausliefe- 
rung von Microsoft Fortran, Ver- 
sion 5.0, begonnen. Der optimie- 
rende Compiler unterstützt die 
Syntax nach ANSI 77, VAX und 
IBM-VS. Die neue Version des 
weit verbreiteten Microsoft 
Compilers ist speziell für die 
Integration von PC-Arbeits- 
plätzen mit Mini- und Großcom- 
putern ausgelegt, wie sie im 
Bereich der Wissenschaft und 
Technik zum Einsatz kommt. Mit 
Hilfe von Microsoft Fortran 5.0 
können Programmierer die effi- 
zientesten und schnellsten For- 
tran-Programme schreiben, die 
für MS-DOS-, PC-DOS- oder MS 
0S/2-Entwicklungsumgebungen 
erstellbar sind. Sowohl die 16- 
Mbyte-Adressierfähigkeit als 
auch die dynamisch verbun- 
denen Bibliotheken (Dynamic 
Link Libraries) unter MS OS/2 
lassen sich unter Microsoft For- 
tran 5.0 nutzen. 

Diese Funktionen zeichnen 
Microsoft Fortran nicht nur als 
produktivsten Fortran-Compiler 
auf dem PC-Markt aus, sie schaf- 
fen auch die Voraussetzung da- 
für, große komplexe Applikatio- 
nen, wie sie typisch für den 
technisch-wissenschaftlichen Be- 
reich sind, zu erstellen und zu 
nutzen. Der Anwender kann be- 
reits existierende VAX-Pro- 
gramme auf seinen PC laden, so 
daß eine hohe Leistung ohne Be- 
grenzung durch teure Hardware- 
Ressourcen zur Verfügung steht. 


Die enorme Geschwindigkeit 
von PCs mit 80386-Mikroprozes- 
soren ist erforderlich, um 
hochentwickelte Applikationen 
im Ingenieurwesen, in der Wis- 
senschaft oder Mathematik aus- 
zuführen. Microsoft Fortran 
unterstützt komplexe Berech- 
nungen und steigert dadurch in 
erheblichem Maße die Pro- 
grammier-Produktivität. Außer- 
dem lassen sich in Microsoft For- 
tran entwickelte Applikationen 
einfach auf andere Systemum- 
gebungen portieren. Nahezu die 
gesamte VAX-Fortran-Syntax 
wird durch Microsoft Fortran, 
Version 5.0, unterstützt, so daß 
Großcomputer- und Minicompu- 
ter-Programme ohne großen 
Lernaufwand für den Software- 
Entwickler auf PCs portiert wer- 
den können. Microsoft geht da- 
von aus, daß durch Fortran 5.0, 
unter MS OS/2 betrieben, rund 
95 Prozent aller heute exi- 
stierenden Fortran-Minicompu- 
ter-Applikationen abgedeckt 
werden. Die neue Compiler-Ver- 
sion ist GSA-geprüft und ent- 
spricht dem ANSI-77-Standard. 

Microsoft Fortran 5.0 bietet 
alle Hilfen und Bibliotheken, die 
auch in den anderen Produkten 
der Microsoft Sprachenfamilie 
zur Verfügung stehen, ein- 
schließlich Grafik-Bibliothek, 
Microsoft CodeView Source-level 
Debugger, Microsoft Editor, 
LINK, NMake, LIB, MS OS/2 Un- 
terstützung und erweiterte Syn- 
tax. Die Grafik-Bibliothek stellt 
Grundelemente für die Erstel- 
lung von Präsentationsgrafiken 
bereit. Sie ist ein neues Element 
in Microsoft Fortran, das alle 
notwendigen Bausteine zur Er- 
zeugung von anschaulichen Dar- 
stellungen aus komplexen Zah- 
lenreihen enthält. Microsoft For- 
tran unterstützt durch Schrift-, 
Farb- und Füllmuster die Gestal- 
tung von Geschäfts-, Technik- 
und wissenschaftlichen Grafiken. 

Mit der neuen Version des 
CodeView-Debuggers für Mehr- 
fach-Anwendungen unter MS 
OS/2 sind Einzelschritt-Dar- 
stellung auf Programm-Ebene, 
schrittweise Protokollierung, 
Unterbrechungspunkte und die 
Darstellung des Inhalts eines 


lokalen Programm-Zwischen- 
speichers möglich. Der Code- 
View-Debugger kann darüber 
hinaus für dynamisch gekop- 
pelte Bibliotheken und sehr 
große MS OS/2-Programme, bis 
zu 128 Mbyte, eingesetzt wer- 
den. Durch den Inkremental- 
Linker, der unter MS 0OS/2 und 
MS-DOS gleichermaßen arbeitet, 
wird der Zeitaufwand für das 
Verbinden von Dateien erheblich 
reduziert, da nur solche Dateien 
neu verbunden werden, in 
denen Änderungen durchgeführt 
wurden. 

Der Microsoft Fortran-Com- 
piler, Version 5.0, läuft auf IBM- 
PCs und kompatiblen Compu- 
tern mit mindestens 320 Kbyte 
Arbeitsspeicher, MS-DOS 3.0 
oder MS OS/2 1.1 (und höhere 
Versionen), die mit zwei doppel- 
seitigen Disketten-Laufwerken 
oder einem doppelseitigen Dis- 
ketten-Laufwerk und einer Fest- 
platte ausgerüstet sind. 
Microsoft empfiehlt den Einsatz 
einer Festplatte. 

Die Version 5.0 des Microsoft 
Fortran-Compilers kostet DM 
1.095,- (exkl. MwSt.). Der Up- 
date-Preis von der Vorgänger- 
version auf Fortran 5.0 liegt bei 
DM 220,- (exkl. MwSt.). 


Microsoft liefert 
QuickC 2.0 aus 


icrosoft gab in diesen 

Tagen die Auslieferung 
des QuickC-Compilers 2.0 be- 
kannt. Die neue Version macht 
das Programmieren in C ein- 
facher und bringt für C-Pro- 
grammierer, die eine integrierte 
Programmierumgebung bevor- 
zugen, erhebliche Produktivitäts- 
gewinne. 

Programmierer werden durch 
den Microsoft QuickC-Ratgeber, 
Kurz-/Langmenüs, eine neue 
Dokumentation und das Compu- 
ter Based Training (CBT) in die 
Lage versetzt, die leistungsstarke 
C-Programmiersprache schnell 
zu beherrschen. 

Der Microsoft QuickC-Rat- 
geber ist ein neues Online-Refe- 
renz-System, das mit Hilfe der 


Hypertext-Technik auf Tasten- 
druck eine Vielzahl von Informa- 
tionen und Beispielprogrammen 
bereitstellt. Die Kurz-/Lang- 
menüs helfen vor allem Einstei- 
gern, sich schnell in der QuickC 
Programmierumgebung zurecht- 
zufinden und produktiv Pro- 
gramme zu schreiben. Demsel- 
ben Ziel dient das CBT. Ein wei- 
teres Element von Microsoft 
QuickG 2.0 ist »C — Programmie- 
ren leichtgemacht«, ein Lehr- 
buch zur Vermittlung der Grund- 
lagen der Programmiersprache C 
und der spezifischen QuickC- 
Compiler Funktionen. 

QuickC 2.0 bietet nun inkre- 
mentelles Kompilieren und Lin- 
ken, das zu einer erheblichen 
Beschleunigung der Kompilier- 
geschwindigkeit führt. Die 
Folge: Die Version 2.0 ist zwei- 
bis dreimal schneller als die bis- 
herige Version. Außerdem ent- 
hält der neue Microsoft QuickC- 
Compiler einen Inline-As- 
sembler. Mit ihm können An- 
wender editieren, kompilie- 
ren/assemblieren sowie per De- 
bugger-Unterstützung Fehler 
suchen, ohne die Program- 
mierumgebung zu verlassen. 

Christian Wedell, Geschäfts- 
führer der deutschen Microsoft 
GmbH, zu den Vorteilen des 
neuen Microsoft QuickC-Com- 
pilers: »Jeder bisherige An- 
wender eines QuickC-Compilers 
sollte wegen der erheblichen 
Produktivitätsverbesserungen 
auf die neue Version 2.0 umstei- 
gen. Programmierer, die bisher 
noch nicht in C programmiert 
haben, weil sie der Meinung 
waren, dies sei zu schwierig, 
werden überrascht sein, wie ein- 
fach und schnell die Program- 
mierung mit QuickC 2.0 geht.« 

Eine weitere neue Funktion 
im Microsoft QuickC-Compiler 
2.0 ist die Unterstützung aller 
Speichermodelle, wie Small, 
Medium, Compact, Large und 
Huge. Außerdem werden die 
Schlüsselworte near, far und 
huge unterstützt, so daß der 
Anwender Speichermodelle im 
Hinblick auf eine maximale Effi- 
zienz mischen kann. 

Die Systemvoraussetzungen 


für die Nutzung des Microsoft Software 
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QuickC-Compilers Version 2.0 
sind: IBM-PC oder kompatibler 
Computer mit mindestens 512 
Kbyte Arbeitsspeicher, DOS 2.1 
bzw. höhere Version und ent- 
weder zwei doppelseitige 5,25- 
Zoll-Laufwerke oder ein doppel- 
seitiges 3,5-Zoll-Laufwerk. 
Microsoft empfiehlt nachdrück- 
lich den Einsatz einer Festplatte. 
Der QuickC-Compiler 2.0 unter- 
stützt CGA-, VGA-, EGA- und 
Hercules-Grafikkarten. 


Die Entwicklung 
des Microsoft QuickC- 
Compilers 2.0 
Programmiersprachen waren bei 
der Gründung von Microsoft die 
Basis der Unternehmensent- 
wicklung. Sie bilden auch heute 
noch einen Schwerpunkt in der 
Produktpalette und haben den 
Fortschritt in der PC-Branche 
vermutlich stärker beeinflußt als 
jede andere Software. Microsoft 
Programmiersprachen wurden 
und werden auf nahezu allen 
führenden Applikationen, wie 
MS-DOS, Lotus 1-2-3 oder 
WordPerfect, eingesetzt und 
sind auch für die Software-Platt- 
form der Zukunft, MS OS/2-Pre- 
sentation Manager, verfügbar. 
Microsoft wird häufig gefragt, 
wie darüber entschieden wird, 
welche Richtung die Entwick- 
lung der Produkte nehmen soll. 
Die folgenden Hintergrund- 
informationen sollen einen Ein- 
blick in die Entstehung eines 
Microsoft Produkts geben, wobei 
es in diesem Fall um die Ent- 
wicklung, die Erstellung und das 
Testen des Microsoft QuickC- 
Compilers 2.0 geht. 


Der Microsoft 

QuickC-Compiler 1.0 

Mit dem Microsoft QuickC-Com- 
piler 1.0 stieg das Unternehmen 
im Oktober 1987 in das C-Com- 
piler-Marktsegment ein. Die 
Entwicklung für dieses Produkt 
begann bereits 1986 Formen an- 
zunehmen und folgte quasi dem 
Erfolg von QuickBASIC 2.0. 
Basierend auf der Resonanz von 
Microsoft QuickBASIC und früh- 
zeitigen Marktforschungen, 
zeigte sich ein großer Markt für 
einen C-Compiler, der die voll- 


ständige Implementierung von 
Microsoft C, zusammen mit 
einer interaktiven, integrierten 
Programmierumgebung, dar- 
stellt. Dazu sollte der Verkaufs- 
preis attraktiv genug sein, so 
daß auch nichtprofessionelle 
Programmierer für einen Ver- 
such, die leistungsfähige Pro- 
grammiersprache C auszupro- 
bieren, zu gewinnen sind. 


Die Untersuchungsphase 

Das vierte Quartal 1987 brachte 
für die Microsoft-Programmier- 
sprachen umwälzende Änderun- 
gen: Microsoft stellte mit 
Microsoft QuickBASIC 4.0, 
Microsoft C 5.0 und Microsoft 
QuickC-Compiler 1.0 drei wich- 
tige Sprachenprodukte vor und 
begann mit der Auslieferung. 

Microsoft QuickBASIC 4.0 bot 
in Form des P-Code-Interpreters 
eine neue Programmierspra- 
chen-Technik, bei der das 
interaktive Verhalten eines Inter- 
preters mit der Geschwindigkeit 
eines Compilers verbunden 
wurde. Der optimierende 
Microsoft C-Compiler 5.0 bot 
dem professionellen C-Pro- 
grammentwickler eine bisher nie 
gekannte Code-Optimierung. In 
QuickC 1.0 wurde die integrierte 
Programmierumgebung für C 
verfügbar. 

Microsofts Philosophie ist es, 
die Produkte ständig den Anfor- 
derungen derzeitiger und zu- 
künftiger Anwender anzupassen. 
Eine 1987 in Auftrag gegebene 
umfassende Studie über die An- 
wender der Microsoft Program- 
miersprachen sollte dabei die 
neuen Richtungen aufzeigen. 
Aus der Studie, die alle Pro- 
grammiersprachen umfaßt, wer- 
den nachfolgend nur die Ergeb- 
nisse von QuickC dargestellt. 

Da die erste Version von 
Microsoft QuickC zum Start der 
Untersuchung bereits ausgelie- 
fert war, konnte Microsoft die 
Erfahrungen der Anwender 
während der ersten zwei Monate 
erkunden. Vorrangiges Ziel der 
Studie war es, Antworten auf 
folgende Fragen zu finden: 
®e Wer sind die Anwender? 
® Welche Faktoren führten 
zum Kauf? 


« Was veranlaßte die Käufer, 
QuickC aus dem gesamten An- 
gebot auszuwählen? 

® Wie und auf welchen Com- 
putern setzen die Anwender 
QuickC ein? 

Die Untersuchung zeigte 
keine besondere Gewichtung 
hinsichtlich beruflicher Funk- 
tion, Sparte oder Branche. 
QuickC wurde von Systemanaly- 
tikern, Programmierern, Ärzten 
und Rechtsanwälten gekauft. 
Gemeinsam war diesen Anwen- 
dern lediglich, daß sie den PC 
als Werkzeug für ihre Arbeit 
nutzten. Wie die Untersuchung 
zeigte, verfügten die QuickC- 
Kunden über eine anspruchs- 
volle Hardware-Ausstattung: 
58% besaßen Computer auf 
80286- oder 80386-Prozessor- 
basis, 88% dieser Computer 
waren mit einem Arbeitsspeicher 
von mindestens 640 Kbyte aus- 
gestattet und 70% der eingesetz- 
ten Betriebssysteme waren MS- 
DOS Version 3.2 oder höhere 
Versionen. 

Außerdem bestand die Mehr- 
heit der Anwender nicht aus An- 
fängern: 72% hatten mehr als 
fünf Jahre Programmier-Erfah- 
rung. Viele Befragte waren al- 
lerdings Einsteiger in der Pro- 
grammiersprache C. 49% der be- 
fragten QuickC-Anwender gaben 
an, daß der Grund für den Kauf 
von QuickC das Erlernen der 
Programmiersprache C ist. 

Nach 60 Tagen (oder weni- 
ger) Arbeit mit QuickG definier- 
ten 72% der Anwender den pri- 
mären Einsatzzweck als Ent- 
wicklungsinstrument von Soft- 
ware. 55% entwickelten Soft- 
ware für den Verkauf oder für 
den Einsatz bei anderen Anwen- 
dern, während 28% Programme 
schrieben, um zu lernen oder die 
Freizeit damit zu gestalten. 

Für den typischen QuickC- 
Anwender sind eine Reihe von 
Produkt-Eigenschaften von 
höherer Bedeutung als diejeni- 
gen traditioneller Benchmarks, 
wie Kompilierzeit oder Ausfüh- 
rungsgeschwindigkeit. Die fol- 
gende Tabelle zeigt eine Auf- 
stellung der verschiedenen Fak- 
toren nach ihrer Gewichtung 
durch die Anwender. 


(Anmerkung: Die Anwender 
wurden gebeten, diese Gewich- 
tung auf einer Skala von 1-5 
vorzunehmen, wobei 5 für »sehr 
wichtig« und 1 für »nicht wich- 
tig« stand.) 


Eigenschaft Wertung 
Gesamt-Gegenwert für das 

investierte Geld 4,51 
Ansehen des Herstellers 4,25 
Qualität der Dokumentation 4,21 
Zuverlässigkeit 4,20 
Integrierter Quellprogramm- 

Debugger 4,17 
Einfache Anwendbarkeit 4,13 
Preis 4,04 
Vollständig integrierte 

Programmier-Umgebung 3,90 
Kompatibilität mit 

Microsoft C 5.0 3,87 
Kompilierunsgeschwindig- 

keit 3,80 
Ausführungs- 

geschwindigkeit 3,78 


Durch eine weiterführende 
Befragung stellte sich heraus, 
daß speziell für die Einsteiger in 
die C-Programmierung mit 
»einfacher Bedienbarkeit« die 
Zeitspanne verstanden wird, die 
investiert werden muß, um pro- 
duktiv zu werden. 

Auf der Basis dieser Informa- 
tionen stellte sich Microsoft die 
Frage, was zu tun ist, um 
QuickC zu einer einfach erlern- 
baren C-Programmierumgebung 
für nahezu 50% der Anwender 
zu machen, die das Produkt kau- 
fen, um C zu lernen. Gleichzeitig 
sollte jedoch die Leistung gebo- 
ten werden, die für die profes- 
sionelle Software-Entwicklung 
benötigt wird. 

Die Lösung ist Microsoft 
QuickC 2.0, bei dem neue Stan- 
dards gesetzt wurden, um den 
Anforderungen der Anwender 
gerecht zu werden. 


Implementierung 

Das QuickC 2.0 Team bestand 
aus Compiler-Experten, die 
Microsoft C 5.1 entwickelt 
haben, sowie aus Mitarbeitern 
des Microsoft QuickBASIC 4.0 
Teams und aus Test- und An- 
wenderschulungs-Teams. 

Bei der Definition der Spezifi- 
kationen für Microsoft QuickC 
2.0 waren die Entwicklungs-, 
Anwenderschulungs-, Marke- 
ting- und Test-Teams beteiligt. 


Jede vorgeschlagene Funktion 
mußte folgendes Kriterium er- 
füllen: Trägt sie dazu bei, 
QuickC einfacher handhabbar zu 
machen, während gleichzeitig 
die Leistung vorhanden ist, um 
die Aufgaben zu erfüllen? 

Die wichtigsten neuen Funk- 
tionen in QuickC 2.0 wurden 
quasi durch die Anwender ent- 
wickelt. Microsofts Herausforde- 
rung als Programmiersprachen- 
Entwickler bestand darin, mit 
technischem Wissen sowie durch 
Kreativität und Innovation ein 
Produkt zu erstellen, das für den 
Anwender wirklich nützlich ist. 
Die folgenden Ausführungen be- 
ziehen sich auf zwei der wichtig- 
sten Elemente der neuen QuickC 
2.0 Technik und darauf, wie 
diese Elemente zum Nutzen des 
Anwenders eingesetzt werden. 


Der QuickC-Ratgeber 
Der Microsoft QuickC-Ratgeber 
ist ein Online-Hilfesystem auf 
Hypertext-Basis. Hypertext ver- 
steht sich als eine bestimmte Art 
der Text-Präsentation, die es 
dem Anwender erlaubt, eine 
bessere Kontrolle über den je- 
weiligen Begriff, den Begriffs- 
Zusammenhang und die Menge 
der dargestellten Informationen 
zu haben. Produkte wie die 
Apple HyperCard, haben die 
Vorteile des Hypertext-Konzep- 
tes demonstriert. Microsoft ist 
der Meinung, daß Hypertext, der 
jeweiligen Programmier-Umge- 
bung angepaßt, einen wesentli- 
chen Beitrag zur besseren Arbeit 
mit Microsoft QuickC 2.0 leistet. 
Ein Hilfesystem in einer inte- 
grierten Programmier-Umge- 
bung muß — um nützlich zu sein 
- umfassend Auskunft geben. Es 
muß mehr Informationen be- 
inhalten, als üblicherweise in 
einem Handbuch zu finden sind. 
Außerdem soll die jeweilige 
Hilfe kontextbezogen sein, 
gleichgültig, an welcher Stelle 
der Programmierumgebung sich 
der Anwender gerade befindet. 
Vor und während der Entwick- 
lung des QuickC-Ratgebers 
wurde ermittelt, wie Program- 
mierer Handbücher benutzen. 
Dabei stellte sich heraus, daß 
Programmierer häufig zusätz- 


liche Informationen und Pro- 
grammbeispiele suchen, für die 
sich in Handbüchern meistens 
der Fußzeilenhinweis »Siehe 
auch...« findet. Im QuickC-Rat- 
geber sind diese »Siehe auch...«- 
Referenzen implizit und explizit 
vorhanden. Außerdem gibt es 
eine Reihe von Anklick-Punkten 
(Hot Spots) und Boxen. Sucht 
der Anwender beispielsweise 
irgendeine C-Bibliotheks-Funk- 
tion, so wird er verschiedene 
Boxen für Beschreibung, Details 
und Beispiele finden. Durch die 
Plazierung des Cursors auf die 
Beispielbox und Klicken der 
Maus erscheint unmittelbar ein 
Beispielprogramm für die jewei- 
lige Bibliotheks-Funktion. Da 
viele Menschen über Beispiele 
am einfachsten eine Program- 
miersprache lernen, ermöglicht 
der QuickC-Ratgeber das Auf- 
rufen eines Beispielprogramms 
in ein Fenster, die Kompilierung 
dieses Programms und den 
sofortigen Test. Auf der anderen 
Seite gibt es »Implizit-Verbin- 
dungen« (Implizit Links), die zu 
Hinweisen und Hilfen führen, 
unabhängig davon, an welcher 
Stelle sich der Anwender gerade 
befindet. So gibt es beispiels- 
weise für jedes C-Schlüsselwort 
und jede Bibliotheksfunktion 
eine implizite Verbindung zur 
jeweiligen ursprünglichen Be- 
schreibungsseite. Unabhängig 
davon, in welchem Programm- 
teil sich der Anwender gerade 
befindet, erscheint die zuge- 
hörige Beschreibung auf dem 
Bildschirm, wenn er den Cursor 
auf eine Bibliotheksfunktion 
setzt und die Hilfe-Taste drückt. 
Auf diese Weise erhält der An- 
wender schnell und einfach die 
notwendigen Informationen. 
Der Microsoft QuickC-Rat- 
geber ist vollständig unabhängig 
von der Systemumgebung im- 
plementiert. Er läßt sich deshalb 
auf einfache Weise in jedes 
andere Produkt einbauen und ist 
bereits bei Microsoft Quick- 
BASIC 4.5 verfügbar. Die 
QuickC-Ratgeberdateien sind 
um bis zu 55% gegenüber dem 
ursprünglichen ASCII-Format 
komprimiert. Auf diese Weise 
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Dokumentationsseiten auf einer 
einzigen Diskette mit 360 Kbyte 
Kapazität unterzubringen. Insge- 
samt repräsentiert der QuickC- 
Ratgeber mehr als 1.800 Doku- 
mentationsseiten. 


Programmierumgebung der zwei- 
ten Generation 

In Bezug auf den Microsoft 
QuickC-Compiler 2.0 gibt es eine 
Reihe weiterer wichtiger Punkte, 
bei denen Microsoft modernste 
Compiler-Technologie eingesetzt 
hat, damit der Anwender so 
schnell wie möglich von der 
Eingabe zu einem ablauffähigen 
Programm kommt. Durch die 
Untersuchung der Art und 
Weise, wie Anwender mit 
Microsoft-Produkten arbeiten, 
wurde deutlich, daß ein typi- 
scher Arbeitsgang aus einem 
Zyklus von Programmeingabe, 
Kompilierung, Fehlersuche, Um- 
schreiben des Programms, Kom- 
pilierung, Fehlersuche usw. be- 
steht. Mit QuickC 2.0 wurden 
deshalb Compiler- und Debug- 
ger-Subsysteme entwickelt, die 
eine bislang nicht vorstellbar 
kurze Zeit für das Durchlaufen 
eines solchen Arbeitszyklus er- 
möglichen. Konfigurierbare Ein- 
gabetasten sowie die »Eingabe 
und Weiter«-Möglichkeit bei der 
Fehlersuche sind weitere Funk- 
tionen, die den Anwender dabei 
unterstützen, schnell und ein- 
fach das Ziel seiner Bestrebun- 
gen, die Erstellung eines ablauf- 
fähigen Programms, zu errei- 
chen. 


Unterstützung für 
DDE-Entwicklungen 
unter MS-Windows 


DE (»Dynamic Data 

Exchange«) ist ein Protokoll 
zur Realisierung dynamischer 
Programmkommunikation unter 
MS-Windows. Es hat gute Aus- 
sichten, in Zukunft in jede Win- 
dows-Applikation integriert zu 
werden, so daß die Applikatio- 
nen untereinander automatisch 
Daten austauschen und Befehle 
aufrufen können, wie dies 


beispielsweise heute schon mit 
Microsoft-Excel möglich ist. 

Problematisch ist jedoch für 
den Windows-Entwickler die 
Integration des DDE-Protokolls 
in seine Applikation. Es sind eine 
Vielzahl von Features zu beach- 
ten und zu implementieren, 
etwa umfangreiche Datenorgani- 
sation, Synchronisationspro- 
bleme, Zerlegung von DDE-Be- 
fehlssequenzen und Ausnahme- 
und Fehlerbehandlungen. 

Deshalb hat die Firma Buch- 
heit software research in Karls- 
ruhe (Telefon 0721/366776) 
einen DDE-Treiber als dynami- 
sche Link-Library entwickelt, der 
auch von ihr vertrieben wird. 
Der Treiber vereinfacht mit 
einem DDE-API die Ansteuerung 
der DDE-Schnittstelle erheblich. 
Er wird über Funktionsaufrufe 
aus der Applikation aufgerufen 
und alle komplexen Vorgänge 
sind im Treibercode verborgen. 
Er kann sowohl auf der Client- 
als auch auf der Server-Seite von 
DDE verwendet werden. Insbe- 
sondere läßt sich mit dem Trei- 
ber eine einfache Einbindung 
von PC-Hardware-Erweiterungs- 
karten in Windows-Software er- 
reichen. Der Treiber kostet DM 
900,- (+MWSt) und wird mit 
umfangreicher Dokumentation 
ausgeliefert. 

Vom gleichen Hersteller ist 
ein Paket mit Namen »Integra- 
tor's DDE-Utilities« lieferbar. 
Hierbei handelt es sich um fer- 
tige Windows-Applikationen, die 
zur Simulation von DDE-Clients 
und -Servern eingesetzt werden 
können. Damit lassen sich DDE- 
Übertragungen (beispielsweise 
aus Excel heraus) leichter testen 
und simulieren. Eine weitere 
Applikation erlaubt die Analyse 
von Daten, die über DDE über- 
tragen werden. Die DDE-Utilities 
sind insbesondere für Entwickler 
gedacht, die ihre Software durch 
Integration von Standardappli- 
kationen entwickeln (etwa auf 
der Grundlage Excel und der 
Datenbank Omnis-Quartz) und 
hierzu auf die DDE-Kommunika- 
tion zurückgreifen. Die DDE- 
Utilities kosten DM 300,- 
(+MWSt). 


Echtzeit- 
Kommunikation 
mit Ganymed 


ie Kommunikations- 

Software Ganymed der 
Firma Quasar hat die 
Postzulassung für die seit 
kurzem verfügbaren schnellen 
Modems mit Fall-Back-Prozedur 
erhalten. Der Telebox-Dienst der 
Deutschen Bundespost benutzte 
Ganymed bereits während der 
CeBIT für Präsentationen und 
Messedemos. Durch die Zulas- 
sung für höhere Übertragungs- 
geschwindigkeiten wird Gany- 
med nun sowohl für Rechner- 
kopplungen, den Anschluß von 
Waagen- und Kassenperipherie 
etc. im Supermarkt, als auch 
wegen der automatisierbaren 
Abläufe und Zeitsteuerung für 
Filialsteuerungen, die vollstän- 
dige Fernwartung und Ferndia- 
gnose von UNIX, C-DOS, MS- 
DOS sowie PS/2-Systemen ein- 
gesetzt. 

Die wesentlichen Vorteile: 
Ganymed ist eine vollständig 
deutsche Entwicklung und nutzt 
deshalb die Stärken der deut- 
schen und europäischen Post- 
infrasturktur, die sonst den An- 
wendern verschlossen bleiben. 

Weiterhin stelle Ganymed 
durch seine Flexibilität die be- 
sonderen Bedürfnisse der ein- 
zelnen Anwender sicher. Clou 
von Ganymed ist der Parallel- 
betrieb zwischen Kommunika- 
tion und PC-Funktionen, da- 
durch lassen sich übertragene 
Dateien und Informationen ohne 
manuellen Zwischenschritt 
direkt elektronisch weiterver- 
arbeiten. 


Turbo Backup jetzt 
noch schneller 


ie neue Version Turbo 
Backup 5.0 soll alle 
Vorzüge einer blitzschnellen, 
komfortablen Datensicherung 
mit der Möglichkeit verbinden, 
Daten zwischen zwei PCs zu 
übertragen. 
Turbo Backup gehört zu den 


schnellsten Backup-Utilities und 
macht die Datensicherung durch 
einfache Bedienung zu einer 
wirklichen »Nebensache«. 

Turbo Backup kann über Sta- 
pel- und Kommandodateien 
automatisiert werden, so daß die 
tägliche Datensicherung dann 
über einen einfachen Tasten- 
druck erfolgt. Der Anwender er- 
hält in einer leicht verständ- 
lichen Anleitung Hinweise dar- 
auf, in welchen Perioden er eine 
Vollsicherung bzw. bloße Er- 
gängzungssicherungen vorneh- 
men sollte, um jederzeit mit dem 
geringsten Aufwand eine opti- 
male Sicherung zu erzielen. 

Turbo Backup kann Pro- 
gramme vor der Sicherung auf 
Virus-Befall prüfen. Wird eine 
verdächtige Abweichung vom 
Originalzustand festgestellt, ist 


bei regelmäßiger Datensiche- 
rung selbst die Radikalkur 
»Formatieren der Festplatte« 
kein Problem mehr. Es besteht 
zu jeder Zeit eine gültige Disket- 
tenserie zur Restaurierung. 

Die neue Version 5.0 von 
Turbo Backup bietet eine ganz 
besondere Überraschung: Das 
Programmodul Turbo Wire er- 
möglicht auch eine Datensiche- 
rung bzw. Datenübertragung 
zwischen zwei PCs über die seri- 
elle Schnittstelle. Bei PCs mit 
unterschiedlichen Diskettenfor- 
maten ist dies eine erstaunlich 
einfach Lösung, sie wieder kom- 
patibel zu machen. Wer die 
Daten seines Laptops auf den 
Tisch-Computer übertragen will, 
braucht beide Geräte nur über 
ein serielles Nullmodem-Kabel 
zu verbinden. 


TURBO BACKUP Ver. 5.00 UTI-MAOO SOFTWARE (C) Dansk Data Support 1986 


Mit dem Menü von Turbo 
Wire läßt sich die Datenübertra- 
gung in beide Richtungen exakt 
steuern. Turbo Backup 5.0 läuft 
auch unter MS-DOS 4.0, ist netz- 
werkfähig und kostet DM 569. 
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Erster EISA- 
Industrie-Chipsatz 


ntel präsentiert den industrie- 

weit ersten Chipsatz zum Im- 
plementierung des 32-bit-EISA- 
Busses (Extended Industry Stan- 
dard Architecture). Der EISA- 
Bus-Chipsatz 82350 von Intel 
besteht aus drei Komponenten 
für den Einbau auf der PC- 
Systemplatine sowie einem Bus- 
Master-Interface Controller für 
Einsteckkarten. 

Muster des Chipsatzes sind 
seit knapp einem Monat verfüg- 
bar, womit Intel - laut Paul 
Otellini, Vice President und 
General Manager der Folsom 
Microcomputer Division von 
Intel — den agressiven Zeitplan 
einhielt, den sich das Unterneh- 
men anläßlich der Ankündigung 
des EISA-Busses im September 
letzten Jahres setzte. 

Otelline kommentierte: »EISA 
erweitert die Einsatzmöglichkeit 
für derzeitige 16-bit-ISA-Ein- 
steckkarten und eröffnet gleich- 
zeitig einen Weg zur Leistungs- 
steigerung durch die Verwen- 
dung von Busmaster-Zusatzpla- 
tinen«. Der ISA-Bus ist auch 
unter der Bezeichnung PC-AT- 
Bus bekannt. 

Otellini fügte hinzu, daß die 
82350-Familie Intels 32-Bit-Bus- 
Programm abrunde und den 
Kunden die Wahl unter zwei In- 
dustriestandard-Optionen biete. 
»Wir haben bereits einen gut 
eingeführten Chipsatz — den 
82311 - der mit der Micro 
Channel-Architektur kompatibel 
ist. Jetzt erwarten wir auch 
künftige Systeme auf der Basis 
unserer Familie 82350«. 


Systemplatinen-Bauteile 
Zur Familie 82350 zählen der 
ISP-Baustein (Integrated System 
Peripheral) 82357, der EISA- 
Bus-Controller (EBC) 82358 und 
drei EISA-Bus-Buffer (EBB) 
82352. 

Das ISP 82357 ist ein hoch- 
integriertes Bauelement mit den 
Funktionen Taktgeber/Zähler, 
Interrupt-Steuerung, Bus-Arbi- 
trierung, DRAM-Auffrischung 
und direkter Speicherzugriff 


(DMA) auf einem einzigen Chip. 
Durch den Einsatz von Intels 
1,5-* m-Technologie CHMOS III 
erzielt das ISP eine DMA-Trans- 
ferrate von 33 Mbyte/s - mehr 
als achtmal so viel, wie der PC- 
AT-Bus. Das ISP übernimmt 
auch die Bus-Arbitrierung und 
entscheidet damit, welche logi- 
sche Funktion (CPU, Busmaster 
oder DMA) zu einer bestimmten 
Zeit Zugriff auf den Bus erhält. 

Der EBC 82358 bildet die 
Schnittstelle zu drei verschie- 
denen PC-Bussen: dem 8-/16- 
bit-ISA-Bus, dem 32-bit-EISA- 
Bus und dem Bus der Host-CPU. 
Er übersetzt die Informationen 
zwischen den Einsteckkarten 
und stellt sicher, daß 8- und 16- 
bit-ISA-Slave- und -Master-Kar- 
ten effizient mit EISA-Zusatzkar- 
ten kommunizieren können. Zu- 
sätzlich erkennt der EBC sowohl 
den 32-bit-386 als auch den 
i486-Mikroprozessor und arbei- 
tet mit beiden zusammen. 

Der Einbausatz für die 
Systemplatine enthält drei EBB 
82352. Sie enthalten die Buffer- 
Logik für Adressen, Daten und 
Parität in jeder von drei Be- 
triebsarten und ersetzen damit 
nicht weniger als 17 TTL-Bau- 
teile. Darüber hinaus helfen die 
EBBs den Systementwicklern, 
die kritischen EISA-Timing-An- 
forderungen einzuhalten. 


Busmaster-Element für 
Einsteckkarten 

Intelligente Zusatzplatinen kön- 
nen in EISA-Systemen durch den 
Bus Master Interface Controller 
(BMIC) Intel 82355 eingesetzt 
werden. Der BMIC bietet eine 
flexible Schnittstelle zwischen 
den lokalen Funktionen der Bus- 
master-Platine und dem EISA- 
Busmaster-Protokoll. 

Der BMIC 82355 arbitriert die 
Busherrschaft und kann die 
Steuerung des Busses von der 
Host-CPU übernehmen. Das ent- 
lastet die CPU von busintensiven 
Aufgaben in anspruchsvollen 
Anwendungen wie Datenbank- 
systemen und File-Servern. In 
Zusatzkarten für Lokalnetz- 
werke, Plattenlaufwerken und 
Grafik ist der BMIC 82355 eben- 
falls von Nutzen. 


Neue Optionen für 
Compaq SLT/286 


ompag stellt zwei neue 

Optionen für den Compaq 
SLT/286 Laptop-Computer vor, 
das externe Batterie-Ladegerät 
und den Auto-Adapter. Das 
externe Batterie-Ladegerät wird 
an das externe Netzteil des 
Compaq SLT/286 angeschlossen 
und lädt einen leeren Batterie- 
Block in eineinhalb Stunden 
wieder auf. Das Ladegerät faßt 
zwei Batterie-Blöcke, die jeweils 
einzeln geladen werden. Die 
Ladezeit hängt von der im 
Batterie-Block verbliebenen 
Restkapazität ab. 

Über den Auto-Adapter kann 
der Compaq SLT/286 Laptop an 
den Zigarettenanzünder eines 
Autos angeschlossen werden 
und die Autobatterie als externe 
Spannungsquelle nutzen. 

Die beiden neuen Optionen 
für den Compaq SLT/286 sind 
über alle autorisierten Compaq- 
Fachhändler erhältlich. Die 
empfohlenen Verkaufspreise für 
das externe Batterie-Ladegerät 
und den Auto-Adapter liegen bei 
DM 329,- bzw. DM 159,-. 

In gleichem Maße, wie die 
beiden neuesten Optionen die 
Einsatzmöglichkeiten des Com- 
paq SLT/286 verbessern, erhöht 
die Basis-Erweiterungseinheit 
dessen Funktionalität. Die Basis- 
Erweiterungseinheit bietet 
Steckplätze für zwei 8-/16-Bit- 
Erweiterungsplatinen im Indu- 
strie-Standard und verfügt 
außerdem — wie der Compaq 
SLT/286 selbst - über eine pa- 
rallele Schnittstelle sowie An- 
schlüsse für einen externen 
VGA-Monitor und eine externe 
Enhanced-Tastatur. Dank dieser 
Schnittstellen können Periphe- 
riegeräte an die Basis-Erweite- 
rungseinheit angeschlossen blei- 
ben, wenn der Compaq SLT/286 
»auf die Reise geht«. Die bereits 
im Oktober 1988 angekündigte 
Basis-Erweiterungseinheit wird 
derzeit weltweit an autorisierte 
Compagq-Fachhändler ausgelie- 
fert. 


Neuer Laptop vom 
Computer-Himmel 


as Münchner Systemhaus 

Computer Sky päsentiert 
den neuen Laptop »Sky Plasma 
286« zu einem Preis von DM 
6950. Der Sky Plasma 286 ist ein 
vollwertiger AT mit 286er CPU, 
12 MHz Taktfrequenz (16 MHz 
Landmark), bis zu 8 Mbyte 
ausbaubarem RAM-Speicher, 
EMS-Standard und page-inter- 
leave. Der Bildschirm besteht 
aus einer Plasmaanzeige mit 
640x400 Bildpunkten. Das stabi- 
le Gehäuse im Aktenkoffer- 
format hat die Ausmaße 
31x36x9cm. 

Laptops erfreuen sich immer 
größerer Beleibtheit. Nicht nur 
für Vertreter in der Industrie 
sind tragbare Computer für die 
Präsentation von Daten unum- 
gänglich. Der Laptop wird im- 
mer mehr die Reiseausführung 
des geliebten Heimcomputers. 
Dies spiegelt sich auch im Preis 
wieder. Laptops werden er- 
schwinglich. Der Sky Plasma 286 
AT ist mit 12 MHz ein sehr 
schneller Laptop. Der Arbeits- 
speicher beträgt 1 Mbyte und ist 


bis zu 8 Mbyte auf der Platine 
ausbaubar. Zudem ist optional 
ein 80287 Coprozessor inte- 


grierbar, so daß der Laptop für 
anspruchsvolle Aufgaben in der 


Bearbeitung großer Datenmen- 
gen geeignet ist. 

Der Datentransfer ist mit Hilfe 
eines 3,5-Zoll-Laufwerks, sowie 
eines seriellen und eines paral- 
lelen Ports möglich. Zusätzlich 
lassen sich ein 5,25-Zoll-Lauf- 
werk und ein externer CGA- 
Monitor anschließen. Die Ein- 
gabe erfolgt über eine Tastatur 
mit 81 Tasten mit integriertem 
numerischem Teil. Der Gas- 
plasma-Bildschirm umfaßt 80 
Buchstaben mal 25 Zeilen. Ein- 
schließlich der eingebauten 150- 
Watt-Stromversorgung wiegt der 
AT im Koffer 7 Kg. 


ScanMan Plus 


ie Münchner Logi GmbH, 

Tochter der Schweizer 
Logitech International S.A., stellt 
das neueste Produkt aus der 
ScanMan-Familie vor, den Scan- 
Man Plus. Den Handscanner gibt 
es in zwei Versionen: für IBM- 


PC, XT, AT, PS/2 (Modell 25 
und 30) sowie kompatiblen 
Systemen und für IBM PS/2 
Modell 50 und höher. Der Scan- 
Man Plus ist in der englischen 
Version ab Juli, in der deutschen 
ab September für voraussichtlich 
DM 740 lieferbar. 

Der ScanMan Plus enthält 
neben dem 400g leichten Scan- 
ner eine Steckkarte, die beiden 
verbesserten Software-Pro- 
gramme Paint-Show Plus (Ver- 
sion 2.2) und ScanMate (Version 
1.2) sowie zwei Handbücher. 
Mit einer Abtastbreite von 106 
mm und Auflösungen von 100, 
200, 300 und verbesserten 400 
Dpi erweist sich der ScanMan 
Plus auch für den professio- 
nellen Einsatz gerüstet. 

Auffällig beim ScanMan Plus 
ist das neue Design und eine 
verbesserte Software. Mit einer 
Breite von 13,5 cm, einer Länge 
von 14 cm und einer Höhe von 
3,5 cm ist der Scanner größer als 
sein Vorgängermodell. Damit 
liegt er nicht nur besser in der 
Hand, sondern ermöglicht auch 
eine ruhigere und damit exak- 
tere Führung beim Scannen. 

Drei Gummiwalzen sorgen 
dafür, daß der ScanMan Plus 
leichter über die Vorlage läuft 
und Verzerrungen beim Abscan- 
nen ausgeschaltet werden. 

Alle wichtigen Einstellmög- 
lichkeiten, wie Helligkeit und 
Wahl der Scan-Kontraste sind 
bedienerfreundlich an der linken 
Seite angebracht und können 
problemlos beim Scannen ver- 
ändert werden. Neu ist auch das 
gelb-grüne Licht des ScanMan 
Plus. Damit können jetzt auch 
Vorlagen mit roten Farbanteilen 
gescannt werden. 

Weiterentwickelt wurde auch 
ScanMate, die eigens für den 
ScanMan entwickelte Software 
von Logitech. Mit DOSScan 
wurde zudem ein nützliches 
Werkzeug in die Software inte- 
griert. DOSScan zeigt dem An- 
wender bereits während des 
Abscannens das Bild auf dem 
Bildschirm. Damit kann schon 
während des Scann-Vorgangs 
mittels der realtime display- 
Funktion die Qualität der Abbil- 


dung kontrolliert werden. Hardware 
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Mit Microsoft- 
Seminaren 
sicher in die 
Zukunft 


D: ständige Leistungsstei- 
gerung in der Hard- und 
Software-Entwicklung läßt den 
Fachkräften der Industrie kaum 
eine Chance, die Möglichkeiten 
dieser Technologie in gleicher 
Schnelligkeit umzusetzen. Dabei 
ist es von sehr großer Bedeu- 
tung, Arbeitsbereiche mit Hilfe 
der EDV zu rationalisieren. Um 
die Integration der EDV und 
damit eine Arbeitserleichterung 
im betriebswirtschaftlichen 
Alltag zu erreichen, setzt Micro- 
soft die Institut-Seminare in 
München und Düsseldorf fort. 
Diese Spezialseminare des 
Microsoft Instituts vermitteln in 
kleinen Gruppen intensiv all das, 
was zum Einstieg in die Pro- 
grammentwicklung nötig ist. 
Modernste Trainingsmethoden 
sowie PC-Demonstrationen und - 
Übungen sind selbstverständlich. 
Die Dozenten befassen sich auch 
im persönlichen Gespräch aus- 
führlich mit den individuellen 
Forderungen und Problemen der 
Teilnehmer. So bekommen pro- 
fessionelle Entwickler durch 
professionelle Schulung die 
Möglichkeit, ihren hohen Wis- 
senstand den neuen Gegeben- 
heiten anzupassen. Das Micro- 
soft Institut bietet Seminare in 
drei Bereichen an: 
Systemsoftware 
Diese Seminare sind für PC-Soft- 
ware-Entwickler bestimmt: 
« Microsoft 0OS/2 
« OS/2-Presentation Manager 
« Microsoft Windows 
e Microsoft LAN-Manager 
®e Microsoft SQL-Server 
Applikationen 
Diese Seminare sind in erster 
Linie für die Mitarbeiter des 
EDV-Benutzer-Services be- 
stimmt: 
« MS-Word 
®e MS-Excel und MS-Excel 
Makro-Programmierung 
®e MS-Multiplan 
« MS-Chart 
Informationsseminare 
Diese Seminare sind für die Mit- 


arbeiter des EDV-Benutzer-Ser- 
vice bestimmt: 

® Einblick in Microsoft System- 
Software 

° LAN-Manager und SQL-Ser- 
ver 


Das Microsoft 
0S/2-Einführungs-Seminar 
Das zweitägige Seminar wendet 
sich an PC-Software-Entwickler, 
die Programmierkenntnisse in 
einer höheren Programmierspra- 
che wie C, Pascal, o.ä. besitzen. 
Neben einem Überblick über 
den Intel 80286-Prozessor wird 
dann als Schwerpunkt dieses 
Seminars auf das Application 
Program Interface (API) einge- 
gangen. In diesem Zusammen- 
hang werden die Funktionen für 
Multitasking, Memory Manage- 
ment und Dynamic Linking aus- 
führlich behandelt. Weitere The- 
men: Geräte- und Datei-Ein-/- 
Ausgabe. Die in diesem Seminar 
gezeigten Programmbeispiele 
sind in Microsoft C geschrieben. 


Datum Tag 
Düsseldorf 

06./07.11.89 Mo./Di. 
München 

02./03.10.89 Mo./Di. 
04./05.12.89 Mo./Di. 


Der Microsoft 
OS/2-Workshop 
Das dreitägige Seminar wendet 
sich an PC-Software-Entwickler, 
die Programmiererfahrungen in 
einer höheren, strukturierten 
Programmiersprache unter MS- 
DOS und C-Kenntnisse besitzen 
sowie das MS-OS/2-Einfüh- 
rungsseminar besucht haben. 
Die Teilnehmer lernen im Vor- 
trag und praktischen Übungen 
am PC den komfortablen Editor 
zu nutzen, Family-API-Pro- 
gramme zu schreiben und De- 
vice-I/O-Routinen zu erstellen 
sowie Multitasking-Funktionen 
zu nutzen und eigene Dynamic- 
Link-Bibliotheken zu erstellen; 
außerdem können sie die erwei- 
terten Speicherverwaltungsmög- 
lichkeiten des Intel 80286 nut- 
zen und mit Hilfe des MS-OS/2 


Memory Managers programmie- 
ren. 


Datum Tag 
Düsseldorf 
08./09./10.11.89 
München 
04./05./06.10.89 
06./07./08.12.89 


Mi./Do./Fr. 


Mi./Do./Fr. 
Mi./Do./Fr. 


Das Microsoft Windows- 
Einführungs-Seminar 
Das zweitägige Seminar wendet 
sich an PC-Software-Entwickler, 
die Programmierkenntnisse in 
einer höheren Programmierspra- 
che wie C, Pascal, o.ä. besitzen. 
Dieses Seminar behandelt die 
Microsoft Windows-Benutzer- 
schnittstelle, die Microsoft Win- 
dows-Systemarchitektur, die 
Programmierwerkzeuge in der 
Praxis und Erstellung von Micro- 
soft Windows-Programmen an 
Beispielen. 


Datum Tag 
Düsseldorf 

23./24.10.89 Mo./Di. 
München 

09./10.10.89 Mo./Di. 
06./07.11.89 Mo./Di. 
11./12.12.89 Mo./Di. 
Der Microsoft Windows- 
Workshop 


Das dreitägige Seminar wendet 
sich an PC-Software-Entwickler, 
die Programmiererfahrungen in 
einer höheren, strukturierten 
Programmiersprache unter MS- 
DOS und C-Kenntnisse besitzen 
sowie das Microsoft Windows 
Einführungsseminar besucht 
haben. 

In diesem Seminar erwirbt der 
Teilnehmer durch praktische 
Tätigkeit an einem PC die Fertig- 
keiten zur Programmierung 
unter Microsoft Windows. Dazu 
werden verschiedene Aufgaben 
gestellt und Übungen abgehal- 
ten. Als Hauptthemen dieses 
Seminars werden Übungen zu 
dem »Windowing«, der gra- 
fischen Programmierschnitt- 
stelle, den Benutzerschnittstel- 


len und dem Dynamic Linking 
durchgeführt. 


Datum Tag 
Düsseldorf 
25./26./27.10.89 
München 
11./12./13.10.89 
08./09./10.11.89 
13./14./15.12.89 


Mi./Do./Fr. 


Mi./Do./Fr. 
Mi./Do./Fr. 
Mi./Do./Fr. 


Microsoft Presentation 
Manager-Einführungs- 
Seminar 

Dieses zweitägige Seminar für 
Windows- und C-Programmierer 
erläutert das Konzept des Pre- 
sentation Managers und gibt 
einen Überblick über seine Pro- 
grammierschnittstellen und 
Fähigkeiten. 

Das Seminar behandelt die 
Benutzerschnittstelle des Presen- 
tation Managers, seine Architek- 
tur, die Programmierwerkzeuge 
in der Praxis und die Erstellung 
von PM-Programmen an Beispie- 
len. 


Übungen abgehalten: Win- 
dowing, Dynamic Linking Libra- 
ries usw. 


Datum Tag 
Düsseldorf 

18./19./20.10.89 Mi./Do./Fr. 
20./21./22.12.89 Mi./Do./Fr. 
München 


29./30.11/1.12.89 Mi./Do./Fr. 


Microsoft LAN-Manager- 
Einführungs-Seminar 
Dieses zweitägige Seminar für 
Netzanwender und Netzwerk- 
Softwareentwickler mit Pro- 
grammiererfahrung in C vermit- 
telt das neue zukunftsweisende 
Programmierkonzept, um den 
MS 0S/2 LAN-Manager bedie- 
nen zu können. 

In diesem Seminar werden die 
neuen Konzepte des LAN-Mana- 
gers erörtert sowie neue und 
zukunftsweisende Programmier- 
methoden (hier ist die »distri- 
buted intelligence Method« zu 
nennen) vorgestellt. Weiterhin 
gibt das Seminar in seinem letz- 
ten Abschnitt eine Installations- 
und Bedienungsanleitung für 
den LAN-Manager und vermit- 
telt so einen »roten Faden« für 
den Netzwerkanwender. 


nars liegt auf der Darstellung 
des API des LAN-Managers. 
Themengebiete wie »Named 
Pipes«, »Mailslots«, »Server- 
Client-Konzept« usw. werden 
mit Hilfe von Übungen und 
praktischen Programmierbei- 
spielen erläutert. 


Datum Tag 
Düsseldorf 

04./05./06.10.89 Mi./Do./Fr. 
06./07./08.12.89 Mi./Do./Fr. 
München 

15./16./17.11.89 Mi./Do./Fr. 
Microsoft SQL-Server- 


Einführungs-Seminar 
Dieses zweitägige Seminar für 
PC-Softwareentwickler erläutert 
die Struktur und das Konzept 
des Microsoft SQL-Server. 
Kenntnisse von MS OS/2 und 
dem MS LAN-Manager sollten 
vorhanden sein, SQL- und C- 
Kenntnisse sind von Vorteil. 
Das Seminar gibt einen Über- 
blick über die Struktur und den 
Aufbau des Microsoft SQL-Ser- 
vers. Neben der Administration 
des Systems werden schwer- 
punktmäßig die Funktionsweise 


und die Einsatzgebiete des SQL- 
Servers behandelt. 


Datum 


Düsseldorf 
11./12.12.89 
München 


Tag 


Mo./Di. 


Datum Tag 
Düsseldorf 

16./17.10.89 Mo./Di. 
18./19.12.89 Mo./Di. 
München 

27./28.11.89 Do./Fr. 
Microsoft Presentation 
Manager-Workshop 


Das dreitägige Seminar wendet 
sich an PC-Software-Entwickler, 
die Programmiererfahrungen in 
C und eventuell in Windows be- 
sitzen sowie das Microsoft 
Presentation Manager Einfüh- 
rungsseminar besucht haben. 

In diesem Seminar erwirbt der 
Teilnehmer durch praktische 
Tätigkeit an einem PC die Fertig- 
keiten zur Programmierung 
unter dem Microsoft Presen- 
tation Manager. Als Hauptthe- 
men dieses Seminars werden das 
Application Program Interface 
(API) des Presentation Managers 
besprochen. Dazu werden ver- 
schiedene Aufgaben gestellt und 


Datum Tag 
Düsseldorf 

02./03.10.89 Mo./Di. 
23./24.11.89 Do./Fr 
04./05.12.89 Mo./Di. 
München 

13./14.11.89 Mo./Di. 
Microsoft 
LAN-Manager-Workshop 


Dieses dreitägige Seminar für 
PC-Softwareentwickler mit Pro- 
grammiererfahrung in C, die am 
LAN-Manager Einführungssemi- 
nar teilgenommen haben, ver- 
mittelt die Fähigkeit zum schrei- 
ben von Programmen, die die 
grundlegenden Bestandteile des 
Microsoft LAN-Managers benut- 
zen. 

Der Schwerpunkt dieses Semi- 


23./24.10.89 Mo./Di. 


Microsoft 
SQL-Server- 
Worksop 
Dieses dreitägige Seminar für 
PC-Softwareentwickler mit 
Kenntnissen in C und SQL, die 
am Einführungsseminar und 
Workshop für OS/2 und den 
LAN-Manager teilgenommen 
haben, vermittelt die Fähigkeit 
zum Schreiben von Program- 
men, die die Funktionen des 
Microsoft SQL-Servers benutzen. 
Der Schwerpunkt dieses Semi- 
nars liegt neben der Installation 
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Programmier- 
Praxis mit € 


"Praxis, Ausg. 4 
Wie mit Hilfe systemnaher Programmierung in C die Hard- und Software der 
MS-DOS-Computer noch effizienter genutzt werden kann, wird in dieser Ausgabe 
gezeigt. 
Aus dem Inhalt: 
+ Die Verwendung von Bios-Routinen in C-Programmen # Algorithmus zur First- 
Fourier-Transformation = Einbinden von Assembler-Routinen in C # Aufbau und 
Steuerung einer IIO-Einsteckkarte mit Bauanleitung 


Best.-Nr. 0994, DMisfr 28,—, 65 230,— 


C-Praxis für Experten, Ausg. 3 

Aus dem Inhalt: 

* Tabellen sortieren + Multilisten und invertierte Organisation * Arbeiten mit 
hashadressierten Listen # Einführung In die Graphentheorie # Suchverfahren in 
Listen # Baumstrukturen # Bildschirmmasken erstellen » Mit UNIX in die Zukunft und 
vielen anderen Programmierbeispielen 

Best.-Nr. 0976, DMistr 28,-, 65 230,— 


Professionell arbeiten mit C, Ausg. 2 

Aus dem Inhalt: 

* Moderne Software-Entwicklungen mit Turbo-C = Elegante Programm-Strukturen 
durch Rekursion + Mathematische Funktionen # Konvertierungs-Routinen 
Best.-Nr. 0964, DMisfr 28,—, 6$ 230,— 


C - Der schnelle Einstieg, Ausg. 1 

Aus dem Inhalt: 

* Alle C-Operationen * Elementare Datentypen * Anweisungen inC * 
Funktionen aufrufen = Die vier Speicherklassen # Zeiger und Vektoren # Nützliche 
Strukturen * Der C-Präprozessor * Wichtige Routinen * Arbeiten mit 
$yntaxdiagrammen 

Best.-Nr. 0440, DMistr 28,—, 65 230,— 


C auf dem Amiga 
Amiga 500, Amiga 1000, Amiga 2000 
Aus dem Inhalt: 

* Für Einsteiger, Umsteiger und Aufsteiger + Das Betriebssystem richtig genutzt * 
C-Compiler im Vergleich + Compilieren - gewußt wie! # Intuition: Screens, 
Fenster, Menüs, Gadgets im Eigenbau * Grafik leichtgemacht # Digitizer: 
Soundeffekte zum Selbermachen # DOS — Disk im Griff und viele Tips und Tricks 
Best.-Nr. 0640, DMistr 28,—, ö$ 230, — 


BESTELLCOUPON: 


Bitte ausfüllen, unterschreiben und einsenden an CHIP-Leser-Service 731, Vogel Verlag und Druck KG, 
Posttach 6740, D-8700 Würzburg 4 


Ja. bitte liefern Sie mir die angekreuzten SPECIAL zu den genannten Preisen plus Versandkosten. 


Datum, Unterschrift 


Vorname, Name a 


Straße, Nr 


AZ, Ort 
Die Lieferung der SPECIAL erfolgt gegen Rechnung plus Versandkostenanteil. 
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und Administration des Systems 
auf der ausführlichen Erläu- 
terung der DB-Library, der Pro- 
grammierschnittstelle des 
Systems. Die Methoden zur Pro- 
grammierung werden mit Hilfe 
von Übungen und praktischen 
Programmierbeispielen ver- 
anschaulicht. 


Datum Tag 


Düsseldorf 
13./14./15.12.89 Mi./Do./Fr. 


München 
25./26./27.10.89 Mi./Do./Fr. 


Microsoft Excel-Makro- 
Programmierung 

Dieses dreitägige Seminar wen- 
det sich an Software-Entwickler, 
die mit Microsoft Excel schon 
einigermaßen vertraut sind. 

Das Seminar gibt anfangs 
einen grundsätzlichen Überblick 
über Microsoft Excel, der für das 
Verständnis der Makroprogram- 
mierung nötig ist. Durch ein- 
fachere Einzelbeispiele wird der 
Teilnehmer zunächst mit der 
Makroprogrammierung vertraut 
gemacht. Es folgt der Einstieg in 
komplexe Problemlösungen mit 
Makros, in denen u.a. sowohl 
selbstdefinierte Menüs und Dia- 
logboxen als auch Funktions- 
und Befehlsmakros eingebunden 
sind. Weiterhin geht das Semi- 
nar auf die Microsoft Excel- 
Programmierumgebung ein, wo- 
bei auf die Möglichkeiten hin- 
gewiesen wird, Informationen 
aus anderer Software mit 
Makros zu verarbeiten (Datev- 
Datensätze) und wie mit Hilfe 
von Makrobefehlen die DDE- 
Schnittstelle von Microsoft Win- 
dows genutzt werden kann. 


Datum Tag 


Düsseldorf 

09./10./11.10.89 Mo./Di./Mi. 
15./16./17.11.89 Mi./Do./Fr. 
27./28./29.11.89 Mo./Di./Mi. 
München 


16./18./18.10.89 Mo./Di./Mi. 


Leserumfrage: 


Zwanzig 
QuickPascal 
zu gewinnen 


Das neue Microsoft System Journal 
will stärker noch als bisher Werk- 
zeug in der Hand professioneller 
Systementwickler, Programmierer 
und erfahrener Anwender sein. 
Deshalb wollen sich Herausgeber 
und Redaktion bemühen, den 
Anforderungen der Leser optimal 
gerecht zu werden. Mit den fol- 
genden Fragen wollen wir mehr 
über unsere Leserschaft erfahren. 


elche Themen soll das Microsoft System 

Journal künftig verstärkt behandeln? Was 
interessiert unsere Leser besonders? Bei welchen 
Entscheidungen können wir Ihnen mit Rat zur 
Seite stehen? Müssen wir Rücksicht nehmen auf 
bei unseren Lesern eingesetzte Hardware? Die 
Ergebnisse dieser Umfrage sollen das Heft noch 
interessanter und lesenswerter machen. Wir 
versichern Ihnen Ihre Angaben vertraulich zu 
behandeln, nicht an Dritte weiterzuleiten und 
nur in anonymisierter Form zu bearbeiten. Über 
die Ergebnisse werden wir in einer unserer 
nächsten Ausgabe berichten. 

Die ersten zehn Einsender erhalten als kleines 
Dankeschön und in Anerkennung ihrer schnellen 
Antwort einen Microsoft QuickPascal-Compiler. 
Damit aber auch Einsender eine Chance haben, 
die dieses Heft vielleicht erst nach einigen Tagen 
am Kiosk entdecken, werden wir weitere zehn 
QuickPascal-Compiler und 35 Bücher unter den 
restlichen Einsendern verlosen. Die Bücher wur- 
den freundlicherweise von den verlagen Addison 
Wesley, Data Becker, Markt & Technik, Sybex, 
Systhema und Tewi zur Verfügung gestellt. Je 
früher Sie sich also entschließen diesen Frage- 
bogen beantwortet an die Redaktion zurückzu- 
schicken, desto größer sind Ihre Chancen mit uns 
gemeinsam abzuheben. Einsendeschluß ist der 
31.10.1989. Der Rechtsweg ist ausgeschlossen. 
Bitte senden Sie den ausgefüllten Bogen an: 


Synergy Verlag GmbH 

Redaktion Microsoft System Journal 
Theresienstr. 40 

8000 München 2 


Ich bin Abonnent des Microsoft System 
Journals: 

Ja O Nein [6 
Wenn ja, seit wann? 

Wenn nein, warum nicht? 


Ich werde das System Journal 
künftig abonnieren. 

Ich werde das System Journal 
regelmäßig am Kiosk kaufen. 

Ich werde das System Journal 
gelegentlich am Kiosk kaufen. 

Mir ist das System Journal zu teuer. 
Mir ist das System Journal zu »populär«! O 
Mir ist das System Journal zu »schwierig«! O 
Sonstiges: 


00 0 © 


Ich wurde auf das Microsoft System Journal 
aufmerksam durch 


eine Anzeige [6) 
Werbeversand 16) 
persönliche Empfehlung (6) 


Ich interessiere mich für Artikel über 

Stark Mittel Wenig 
MS-DOS 
MS 05/2 
Windows 
LAN/SQL-Technologie O 


o0o0Oo0 


(6) (6) 
oO [6) 
[6) [6) 
[6) (6) 
Macro Assembler [6] [6) [6] 
& [6) (6) (6) 
COBOL [6) [6) [6) 
FORTRAN [6) 16) [6) 
Pascal [0] [6) [6] 
BASIC (6) [6) [6) 
Hardware [6] [6] [6] 


Der C-Einsteigerkurs im Microsoft System 
Journal ist für mich 

interessant (0) 
uninteressant 

zu schwierig (6) 
zu einfach (6) 


Ich programmiere in 
BASIC 

G 

Pascal 

COBOL 

FORTRAN 
Assembler 

SQL 

anderen Sprachen 


o0o00000 


Ich beschäftige mich 
professionell 

in meiner Freizeit 
gar nicht 

mit Programmierung 


o0o0O0 
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10. 


11. 


12. 


13, 


14. 


Ich arbeite als 

Programmierer/Systementwickler (6) 
Systemberater (6) 
DV-Entscheider (6) 
Berufstätiger in einem sonstigen DV-Beruf O 
EDV-orientierte(r) Student(in) (6) 
in einer nicht-EDV-orientierten Tätigkeit O 


Ich bin 

Selbständiger 
Leitender Angestellter 
Angestellter 

in Ausbildung 
Sonstiges 


oo0o00 


Ich arbeite 

unter MS-DOS 

unter MS 05/2 
UNIX/XENIX 
Macintosh-Betriebssystemen 
Sonstigen 


o0o000 


Ich habe Erfahrung in der Entwicklung für 


MS-DOS [6] 
MS 05/2 (6) 
Windows (6) 
UNIX/XENIX [6) 
Netzwerke [6] 


Ich bin an Fortbildungsveranstaltungen des 
Microsoft System Journals zu folgenden 
Themen interessiert: 
Entwicklung für MS 05/2 
Entwicklung für Windows 
Entwicklung mit C 
Systemberatung 
Sonstiges 


oo00 


Ich bin an einem Meinungsaustausch mit 
anderen Entwicklern zu folgenden Themen- 
kreisen interessiert: 
Entwicklung für MS 05/2 
Entwicklung für Windows 
Entwicklung mit C 
Systemberatung 
Sonstiges 


o000 


Ich arbeite auf 
einem 8086/88-PC 
einem 80286-PC 
einem 80386-PC 
einer Workstation 
einem Macintosh 


o0000 


Ich beabsichtige in den kommenden zwölf 
Monaten die Anschaffung 

neuer Programmierwerkzeuge [6] 
neuer Standardapplikationen (6) 
neuer Rechner 16) 
sonstiger neuer Hardware 

(Karten, Drucker, etc...) [6) 


15. Ich finde das Microsoft System Journal 


interessant O uninteressant [6) 
aktuell O unaktuell (6) 
zu Software-lastig O zu Hardware-lastig O 
verständlich 

geschrieben O unverständlich (6) 
professionell O unprofessionell (6) 
übersichtlich O unstrukturiert [0] 
zu teuer O angemessen oO 


16. Ich nutze die beigefügte Listing-Diskette: 
Ja O Nein 


17. Ich lese folgende andere Computer-Fach- 
zeitschriften: 
MS Journal/etc 
ct 
mc 
Design & Elektronik 
PC Woche 
Computerwoche 
Computerzeitung 
CHIP 
CHIP TOOL 
DOS International 
Computer Persönlich 
PC Magazin 
Zeitschriften aus den USA 
keine 
andere 


OOO0OO0O0000000000 


18. Ich ziehe es vor, wenn die Dokumentation 
zu Microsoft Entwicklungswerkzeugen in 
folgender Sprache abgefaßt ist: 
englisch [6) 
deutsch [6) 


Anschließend haben Sie hier Gelegenheit, Ihren 
Kommentar zum Microsoft System Journal auf- 
zuschreiben - natürlich nur, wenn Sie wollen: 


Wichtig! Bitte vergessen Sie nicht, Ihre An- 
schrift anzugeben — damit Ihr QuickPascal Sie 
auch erreicht, wenn Sie zu den Gewinnern gehö- 
ren. 

Datenschutzhinweis! Wir versichern Ihnen, 
daß wir Ihre Adresse und Ihre persönlichen An- 
gaben nicht an Dritte weitergeben werden und 
daß die Auswertung Ihrer Antworten unabhängig 
von Ihrer Adressenangabe erfolgt. 


Name: 
Straße: 


PLZ, Ort: 
Land: 


Wichtige Bücher 
über OS/2 


D: wichtigste bei der Pro- 
grammierung in einer 
neuen Betriebssystemumgebung 
sind gute Nachschlagewerke und 
Einführungen mit vielen instruk- 
tiven Beispielen. Für OS/2 sind 
solche Bücher nun erhältlich. 
Auf Englisch liegen vor: das 
dreibändige Nachschlagewerk 
05/2 Programmer's Reference 
von Microsoft und die mit vielen 
Beispielen versehene Einführung 
Programming the 05/2 Presen- 
tation Manager von Charles 
Petzold. Beide Titel sind die 
Standardwerke in ihrem Bereich. 
Auf Deutsch gibt es zwei ähn- 
lich geartete Werke, und zwar 
das OS/2-Programmierhandbuch 
von David E. Cortesi, das zum 
großen Teil als Nachschlagewerk 
konzipiert ist, und Peter Norton's 
05/2 für Insider von Robert 
Lafore und Peter Norton. 

Die Referenzhandbücher von 
Microsoft sind ein Muß für jeden 
OS/2-Programmierer, sie gehö- 
ren deshalb auch zum Lieferum- 
fang des Programmier-Toolkits 
für den OS/2 Presentation 
Manager (PTK). Sie sind jedoch 
auch separat über den Verlag 
Microsoft Press (in Deutschland 
über Vieweg) erhältlich. In der 
Kombination mit dem OS/2 Pre- 
sentation Manager Softset von 
Microsoft gibt es damit einen 
preiswerten Einstieg in die Pro- 
grammierung unter OS/2 für 
diejenigen, die bereits OS/2 und 
einen Microsoft-Compiler besit- 
zen. 

Im Band 1 werden die kon- 
zeptionellen Grundlagen der 
Programmierschnittstelle von 
OS/2 erläutert. Der Band 2 ent- 
hält eine umfassende alphabeti- 
sche Beschreibung aller Pro- 
grammierfunktionen des 0OS/2 
Presentation Managers. Der 
Band 3 gleicht dem Band 2, ent- 
hält jedoch nur die Beschreibung 
der Basisfunktionen des OS/2- 
Kerns ohne den Presentation 
Manager. Wie gesagt, ohne diese 
Bände geht nichts. 

Charles Petzold hat sich be- 
reits mit seinem Buch Program- 


ming Windows und vielen Arti- 
keln in Fachzeitschriften (zum 
Beispiel auch im Microsoft 
System Journal) einen sehr 
guten Namen gemacht. So wie 
man bei der Programmierung 
unter Windows nicht um sein 
Buch herumkommt, ist auch 
Programming the OS/2 Presenta- 
tion Manager jedem Einsteiger, 
aber auch den fortgeschrittenen 
Programmierern, sehr ans Herz 
zu legen. Charles Petzold ver- 
steht es, komplizierte Themen 
verständlich und nachvollzieh- 
bar darzustellen. Dazu trägt 
auch bei, daß er Beispiele mit 
hohem Wiederverwendungswert 
einsetzt. Wer dieses Buch durch- 
gearbeitet hat, kann sich als 
wirklichen Experten in der 
OS/2-Programmierung bezeich- 
nen. 

Doch rund zweieinhalbtau- 
send Seiten englische Fach- 
begriffe sind nicht jedermanns 
Sache; viele Programmierer zie- 
hen eine deutsche Dokumenta- 
tion vor. Hier erscheinen nach 
und nach Übersetzungen 
umfangreicher amerikanischer 
Bücher. Markt & Technik hat 
kürzlich zwei gute Werke vor- 
gelegt, Peter Norton's OS/2 für 
Insider von Robert Lafore und 
dem amerikanischen Software- 
Star Peter Norton und das OS/2- 
Programmierhandbuch von dem 
erfahrenen Fachautor David E. 
Cortesi. Beide Bücher behandeln 
leider noch nicht die Pro- 
grammierung des Presentation 
Managers, sie beschränken sich 
noch auf die Basis-Funktionen 
von OS/2, wie sie auch schon in 
der Version 1.0 vorhanden 
waren. Dies ist bedauerlich, da 
OS/2 erst mit dem Presentation 
Manager seine ganze Stärke 
zeigt. Doch auch ohne Hinweise 
auf seine Programmierung sind 
die Bücher sehr nützlich, da sie 
viele der wesentlichen Konzepte 
von OS/2, wie Multitasking, 
Prozesse, Threads, Semaphore, 
Pipes, Queues, Monitore, Signale 
und dynamisches Linken, be- 
handeln. Für Programmierer, die 
mit der meldungsgesteuerten 
Verarbeitung des Presentation 
Managers noch nicht zurecht- 
kommen, ist dies vielleicht sogar 


der bessere Weg, sich mit diesen 
neuen Dingen vertraut zu 
machen. 

Das Buch von Robert Lafore 
und Peter Norton ist als Tutorial 
konzipiert, das den Leser schritt- 
weise zuerst an einfache The- 
men heranführt und dann erst 
nach und nach zu schwierigeren 
und komplexeren Themen. Es 
wendet sich also nicht an erfah- 
rene Experten, sondern vor 
allem an solche Leser, die nur 
geringe Programmierkenntnisse 
haben. Besonderer Wert wird 
deshalb auf Beispiele gelegt. Alle 
Systemaufrufe werden anhand 
kleiner, lauffähiger Beispielpro- 
gramme erläutert. Die Autoren 
merken dazu ganz richtig an: 
»Die beste methode, etwas zu 
lernen, besteht darin, es zu tun.« 
Alle Beispielprogramme werden 
auf einer 1,2 Mbyte-Diskette 
mitgeliefert. 

Etwas theoretischer geht 
David E. Cortesi an das Thema 
heran. Sein Buch gliedert sich in 
zwei Teile, die etwa jeweils die 
Hälfte ausmachen. Im ersten 
Teil werden die wichtigsten Ei- 
genschaften von OS/2 beschrie- 
ben, der zweite Teil enthält eine 
umfangreiche Beschreibung aller 
Systemaufrufe des OS/2- 
Kernels. Hier wird für jeden Sy- 
stemaufruf detailliert aufgeführt, 
welche Parameter erwartet wer- 
den, was der Aufruf macht, wel- 
che Fehlermöglichkeiten beste- 
hen und wie der Aufruf und die 
verwendeten Datenstrukturen in 
C aussehen. Etwas unschön ist, 
daß sich bei der Übersetzung in 
die C-Beispiele zahlreiche Pas- 
cal-Kommentare (in geschweif- 
ten Klammern) eingeschlichen 
haben. Die Beschreibung eignet 
sich aber auch für Assembler- 
programmierer. Das Buch eignet 
sich gleichermaßen als Einfüh- 
rung in die Programmierung 
unter OS/2 als auch als Nach- 
schlagewerk für die Systemauf- 
rufe. 


Einen Auszug aus dem OS/2- 
Programmierhandbuch von 
David E. Cortesi über die 
Mausprogrammierung können 
Sie ab der Seite 23. 


Bücher 


Microsoft: 05/2 Pro- 
grammers Reference 
Including Presenta- 
tion Manager, 
Volume 1. Redmond, 
Microsoft Press, 
1989; 740 Seiten; 
ISBN 1-55615-220- 
5; $29.95. 


Microsoft: OS/2 Pro- 
grammers Reference 
Including Presenta- 
tion Manager, 
Volume 2. Redmond, 
Microsoft Press, 
1989; 557 Seiten; 
ISBN 1-55615-221- 
3; 329.95. 


Microsoft: OS/2 Pro- 
grammers Reference, 
Volume 3. Redmond, 
Microsoft Press, 
1989; 430 Seiten; 
ISBN 1-55615-222- 
1; $19.95. 


Charles Petzold: Pro- 
gramming the 0S/2 
Presentation Mana- 
ger. Redmond, 
Microsoft Press, 
1989; 850 Seiten; 
ISBN 1-55615-170- 
5; $29.95. 


Robert Lafore, Peter 
Norton: Peter Nor- 
ton's OS/2 für Insi- 
der. Ein Leitfaden 
zur Programmierung 
unter OS/2. Markt & 
Technik, 1989; 567 
Seiten; ISBN 3- 
89090-646-X; 

DM 89,-. Mit 1,2 
Mbyte Diskette. 


David Cortesi: 08/2 
Programmier- 
handbuch. Das 
unentbehrliche 
Nachschlagewerk für 
0S/2-Programmie- 
rer. Haar, Markt & 
Technik, 1989; 470 
Seiten; ISBN 3- 
89090-732-6; 

DM 89,-. 
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VMM, Virtual Memory Manager: 


Eine virtuelle 
Speicher- 
verwaltung 
inC 


Durch die Größe des Hauptspei- 
chers, wie er unter Microsoft OS/2 
einem Programm zur Verfügung 
steht, werden Programmierer 
ziemlich verwöhnt. Es ist z.B. jetzt, 
nachdem Magma's Programmier- 
editor ME (nicht zu verwechseln 
mit dem Microsoft Editor) auf 
OS/2 portiert wurde, ohne wei- 
teres möglich, Dateien zu bearbei- 
ten, die größer sind als der vor- 
handene Hauptspeicher. Mit der 
DOS-Version des Editors war so 
etwas kaum zu bewerkstelligen. 
Um sehr große Dateien editieren 
zu können, mußte die DOS-Version 
von ME verbessert werden und als 
logische Konsequenz daraus ent- 
stand die virtuelle Speicherverwal- 
tung VMM. 


in weiterer Grund, der zur Entwicklung des 

VMM (engl. virtual memory manager) führ- 
te, sind die Unzulänglichkeiten der Funktion 
malloc aus der C-Laufzeit-Bibliothek. In verschie- 
denen Compiler-Versionen wurden die Funktio- 
nen zur Speicherbelegung unterschiedlich imple- 
mentiert, alle Lösungen sind aber für den norma- 
len Programmierer gleichermaßen undurchsich- 
tig. 

Aus der Sicht eines Programmierers ist es 
natürlich vorteilhaft, malloc dieses Undurchsich- 
tige zu nehmen und die einzelnen Bestandteile 
von malloc in eigene Funktionen zur Speicher- 
verwaltung einzubauen, die sich dann auch ver- 
nünftig mit dem Microsoft CodeView-Debugger 
austesten lassen. Das ist vor allem dann sinnvoll, 
wenn der begründete Verdacht besteht, daß ein 
Programm eine Reihe belegter Speicherbereiche 
verfälscht hat. 

Nicht zuletzt sollte ME so erweitert werden, 
daß er nicht mehr durch einen kleinen Rest 
freien Hauptspeichers eines Systems einge- 
schränkt wird, denn es soll immer noch Leute 
geben, die mit 256-Kbyte-Maschinen arbeiten. 
Wenn man den Speicher berechnet, den allein 
DOS belegt, dazu die Größe von speicherresiden- 
ten (TSR-) Programmen und .EXE-Dateien 
addiert, kommt man schnell zu dem Ergebnis, 
daß auch bei 640 Kbyte Hauptspeicher kaum 
noch Platz für größere Anwendungen bleibt. 

Ein Ziel bei der Entwicklung der virtuellen 
Speicherverwaltung für den ME-Editor war es, 
das System so einfach und offen zu gestalten, 
daß es ohne weiteres auch für andere Anwen- 
dungen verwendet werden kann. Außerdem 
sollte der VMM auch die Möglichkeiten von evtl. 
vorhandenem Expanded Memory nutzen können. 
(Obwohl der VMM für den ME-Editor EMS unter- 
stützt, wird auf die Implementierung hier nicht 
weiter eingegangen. Die Problemlösung kann der 
Leser als eine Art Übung für sich ansehen.) Die 
API's von VMM sind in Tabelle 1 dargestellt. 

Der VMM muß im Large-Modell kompiliert 
werden, da wir Zeiger vom Typ far benutzen und 
einige Routinen der C-Bibliothek (z.B. memset) 
diesen Typ erwarten. Für ein anderes Speicher- 
modell sind kleinere Anpassungen notwendig. 

Im folgenden Text wird zur Erweiterung des 
VMM einiges angemerkt, das Sie aufnehmen und 
realisieren sollten. Wir würden uns freuen, wenn 
Sie solche Ideen durchführen und uns dann mit- 
teilen, wie Sie bei der Umsetzung vorgegangen 
sind und wie sich diese Änderungen auf die Lei- 
stungsfähigkeit des VMM auswirken. 


Initialisierung des VMM 


Als erstes muß jedes Programm, das den VMM 
benutzt, die Initialisierungs-Funktion VMlnit auf- 
rufen. Damit wird eine Datei erzeugt, die zur Se- 
kundärspeicher, d.h. Festplatte oder RAM-Disk, 


VMInit 

Initialisiert VMM und muß zum Beginn einer 
Anwendung, vor Belegung der ersten Speicher- 
blöcke, aufgerufen werden. 


VMTerminate 
Beendet VMM und wird zum Abschluß einer 
Anwendung aufgerufen. 


char far *MemDeref(HANDLE h) 
Berechnet aus dem Wert der Handle h die Spei- 
cheradresse des zugehörigen Speicherblocks. 


HANDLE MyAlloc(unsigned size) 

Belegt im virtuellen Speicher einen Speicher- 
block der Größe size, füllt ihn mit Null und gibt 
eine Handle auf diesen Block zurück. 


MyFree(HANDLE h) 
Gibt den durch die Handle h referierten Block 
frei. 


SetVMPageSize(int kbytes) 
Verändert die Standardgröße von Seiten auf 
kbytes Kbyte. Z.B. setzt SetVMPageSize(16) die 
Defaultgröße auf 16 Kbyte. 


MakePageDirty(HANDLE h) 

Markiert die Handle, in der sich der durch 
Handle h referierte Speicherblock befindet, als 
verändert. 


gebraucht wird, die sogenannte Swap-Datei. 
VMInit prüft nach, ob im Environment die 
Variable METEMP definiert wurde, um den voll- 
ständigen Pfadnamen für die Swap-Datei festzu- 
legen. Ist METEMP undefiniert, wird die Swap- 
Datei im aktuellen Verzeichnis erzeugt. Die 
Benutzung von METEMP ist z.B. sinnvoll, wenn 
die Swap-Datei auf einer RAM-Disk liegen soll, 
um das Ein- und Auslagern (engl. swapping) von 
Speicherblöcken zu beschleunigen. 

METEMP kann leicht durch Zufügen einer 
Zeile in die AUTOEXEC.BAT-Datei definiert wer- 
den: 
set METEMP = <Pfadname> 

Der Name der Swap-Datei wird mit Hilfe der 
Funktion mktemp, die in der C-Laufzeit-Biblio- 
thek enthalten ist, festgelegt. Die Funktion benö- 
tigt als einzigen Parameter eine Zeichenkette als 
Muster und erzeugt damit eine eindeutige Datei- 
bezeichnung. In diesem Fall wird das Muster 
VMXXXXXX an mktemp übergeben und die Funk- 
tion ersetzt alle X durch andere Zeichen, so daß 
der Dateiname sich von allen anderen im Ziel- 
verzeichnis unterscheidet. Zum Beispiel könnte 
mktemp an VMlnit die Zeichenkette VM065291 
zurückgeben und es würde eine Swap-Datei mit 
diesem Namen angelegt. 

An dieser Stelle möchte ich eine der wesent- 
lichen Einschränkungen des VMM erwähnen, 


nämlich die Begrenzung des Speichers zum Ein- 
und Auslagern auf die Größe des Swap-Mediums, 
d.h. RAM-Disk oder Festplatte (zusätzlich zum 
freien Speicher im Expanded Memory). Eine 
denkbare Verbesserung von VMM wäre also die 
Benutzung mehrerer Platten zum Ein- und Aus- 
lagern von Speicherblöcken, eventuell sogar über 
ein ganzes Netzwerk, also auf andere Rechner, 
z.B. einen File-Server. Dabei müssen aber unbe- 
dingt die DOS-Restriktionen, d.h. die maximale 
Anzahl gleichzeitig geöffneter Dateien einer 
Anwendung, beachtet werden! 


Beenden des VMM 


Bevor die Anwendung beendet werden kann, 
muß sie die Routine VMTerminate aufrufen, da- 
mit die Swap-Datei ordnungsgemäß geschlossen 
und gelöscht wird. Zusätzlich eingebaute Funk- 
tionen, z.B. statistische Analysen des Swapping 
oder Verteilung der Swap-Dateien über mehrere 
Platten oder Rechner, sollten an dieser Stelle 
ebenfalls abgeschloßen werden. 


Handle 0x| 0003 | 0400 


Offset in 
der Page 


Page = 4 Kbyte im normalen Speicher, 16 Kbyte im Expanded-Hemory 
tatrerich einer Page des Expanded-Memory). 


Speicheranforderungen 


Um Speicherplatz vom VMM anzufordern, wird 
die Funktion MyAlloc benutzt. Sie ersetzt zum 
einen die Standardroutine malloc, und da der 
belegte Speicherbereich mit '0' überschrieben 
wird, auch die Funktion calloc. An MyAlloc wird 
als Argument die Anzahl der benötigten Byte 
übergeben, zurück erhält man die Referenz auf 
eine Speicherseite, die ich im folgenden als 
Handle bezeichne. 

Für diese Art von Referenz hat sich auch im 
Deutschen der Begriff Handle (im Englischen 
eigentlich soviel wie Henkel, Griff) weitgehend 
durchgesetzt, nicht zuletzt durch den häufigen 
Gebrauch in Microsoft Windows. Eine Handle ist 
einfach eine Bezeichnung für einen Speicher- 
block und wird von internen Routinen als Zeiger 
auf ein Objekt gebraucht. Der Wert dieser Varia- 
blen ist normalerweise für eine Anwendung mit 
dem VMM völlig bedeutungslos. 

Der VMM verwendet einen vorzeichenlosen 
Long-Wert als Handle. Die oberen 16 Bit werden 
als Nummer des Speicherblocks, die unteren 16 
Bit als Offset (mit O0 beginnend) innerhalb der 
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» Listing 1: 
Struktur zur Defini- 
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kopfs 
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Seite interpretiert. Eine Handle mit dem Wert 
00030400H zeigt also auf einen Speicherblock, 
der sich 400H Bytes vom Anfang des Blocks 3 be- 
findet (Bild 1). 

Mit dieser Konstruktion können also fast 64 
Kbyte Seiten mit jeweils 64 Kbyte Inhalt gehand- 
habt werden, das sind insgesamt über 4 Giga- 
byte, die VMM adressieren kann. Selbst bei heu- 
tigen Plattenkapazitäten ein durchaus ausrei- 
chender Wert. 


Aufbau einer Seite 


Wie oben beschrieben, erwartet die Funktion 
MyAlloc als Argument die Größe des benötigten 
Speicherblocks, möglichst eine Potenz von 2, und 
legt, falls in den bereits existierenden Seiten 
nicht mehr genug Platz vorhanden ist, eine neue 
Seite an. Dafür benutzt er die Struktur PAGE aus 
VM.H (Listing 1). 


typedef struct page 
{ 


struct page *next; /* Zeiger auf nächste freie Seite */ 


char far *memaddr; /* Speicheradresse der Seite * 
unsigned long diskaddr; /* Plattenadresse der Seite ”/ 
PAGEID id; /* Seitennumer “ 
unsigned long LRUcount; /* Zeit-Feld für LRU-Algorithmus */ 
unsigned pagesize; /* Seitengröße in Byte DR 


/* Zgr auf 1. freien Speicherblock * 
/* Anzahl freier Bytes der Seite */ 
/* Bytes des größten freien Blocks */ 


unsigned freebyte; 
unsigned bytesfree; 
unsigned maxcontigfree; 


unsigned flags; 

#define PAGE_IN_MEM 
#define PAGE_ON_DISK 
#define 1S_DIRTY 0x0004 

#define SET_PAGE_DIRTY(p) ((p) > flags != 1S_DIRTY) 
#define NON_SWAPPABLE 0x0008 

#define PAGE_IN EM 0x0010 

} PAGE; 


0x0001 
0x0002 


Eines der ersten beiden Felder der Struktur 
PAGE, memaddr und diskaddr, adressiert die 
Handle, abhängig davon, ob sie sich im RAM 
oder im Sekundärspeicher (Festplatte oder RAM- 
Disk) befindet. Zur Adressierung im RAM ist ein 
far-Zeiger notwendig, für die Platte der Offset 
vom Anfang der Swap-Datei. Zusätzlich dazu 
enthält die Struktur noch die (eindeutige) Num- 
mer der Seite, deren Größe (da der VMM mit 
verschiedenen Seitengrößen arbeiten kann), eine 
Bit-Maske, um den Status abzubilden (Steht die 
Seite im RAM und/oder auf der Platte? Wurde 
sie verändert?), einen Zeiger auf das erste freie 
Byte (zum Aufbau einer verketteten Liste freier 
Speicherblöcke) und ein Zeit-Feld des Swapping- 
Algorithmus für das Ein- und Auslagern. Hier 
wird der sogenannte LRU-Algorithmus benutzt, 
der die am längsten nicht verwendete (engl. least 
recently used) Seite bewegt. Außerdem beinhal- 
tet die Struktur PAGE noch Felder für die Anzahl 
der freien Bytes der Seite insgesamt und für den 
größten zusammenhängenden freien Speicher- 
block. Diese beiden Werte ermöglichen das Ver- 
binden benachbarter, freier Speicherblöcke. Auf 
diese Erweiterungsmöglichkeit für den VMM 
gehen wir später noch genauer ein. 


Um die Leistungsfähigkeit der Anwendung zu 
erhöhen, kann man mit der Größe der Seiten ex- 
perimentieren. Dazu dient die Routine SetVM- 
Size, die allerdings direkt nach VMlnit, zumin- 
dest aber vor der ersten Anlage von Seiten, und 
höchstens einmal im Programmablauf aufgerufen 
werden sollte, da der Swapping-Algorithmus eine 
konstante Seitengröße voraussetzt. Als Stan- 
dardgröße für Seiten wurden 4 Kbyte für kon- 
ventionellen Speicher und 16 Kbyte für Ex- 
panded Memory festgelegt. Damit kann der VMM 
das Speicherkonzept des Expanded Memory voll 
unterstützen. Innerhalb der Seiten werden freie 
Speicherblöcke durch eine verkettete Liste ver- 
waltet, die durch die Struktur FREEINFO defi- 
niert ist: Der Kopf jedes freien (und angelegten) 
Speicherblocks enthält die Größe des Blocks und 
einen Zeiger auf den nächsten freien Block. Der 
letzte Block innerhalb der verketteten Liste hat 
den Zeigerwert FFFFH und ist damit als Listen- 
ende gekennzeichnet (eine typische Verkettung 
zeigt Bild 2). Da die Liste in keiner Weise geord- 
net oder strukturiert ist, sind natürlich Verbesse- 
rungen möglich, wie sie im Zusammenhang mit 
der Freigabe von Speicherblöcken genauer be- 
schrieben sind. Beim Aufruf der Funktion My- 
Alloc wird die verkettete Liste durchlaufen, bis 
der erste Speicherblock mit der notwendigen 
Größe erreicht ist. Diese Suche übernimmt die 
Funktion FindNContigBytesFree. Befindet sich im 
Hauptspeicher kein passender Block, wird als 
nächstes auf der Festplatte oder der RAM-Disk 
weitergesucht. Wenn auch dort kein Speicher- 
block mit der benötigten Größe frei ist, wird die 
Funktion AllocPage aufgerufen, die für eine neue 
Seite Kopf und Pufferbereich anlegt. Danach hat 
MyAlloc den Zeiger auf eine Seite mit der genü- 
genden Anzahl freier Bytes und es kann die ver- 
kettete Liste nach einem passenden freien 
Speicherblock durchsuchen, dessen Inhalt mit 
Null überschrieben wird. Zuletzt gibt MyAlloc an 
die aufrufende Routine die Handle des gefun- 
denen Blocks zurück. 
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Auslagern von Seiten 


In dieser Version von VMM wird der Speicher für 
eine Handle durch den Aufruf der Routine 
_dos_alloemem (aus der Microsoft-C-Bibliothek) 
belegt, hinter der sich die DOS-Routine Int 21H 
mit Funktion 48H verbirgt. Durch die Benutzung 


der DOS-Speicherroutinen kann auf die Funktion 
malloc der C-Laufzeit-Bibliothek völlig verzichtet 
werden. (Die Köpfe der Seiten werden zwar in 
dieser Version trotz allem mit malloc angelegt, 
aber das könnte genausogut mit DOS-Speicher- 
routinen erreicht werden.) Durch die Benutzung 
von _dos_allocmem tritt irgendwann die Situa- 
tion ein, daß der Kopf für eine neue Seite exi- 
stiert, aber für den Seitenrumpf kein Speicher 
mehr frei ist. Dann muß eine vorher angelegte 
Seite ausgelagert und abgespeichert werden, um 
Platz für den nächsten Speicherblock zu schaffen. 
Diesen Vorgang nennt man »swapping« oder 
»paging« auf die Swap-Datei. Die Belegung aller 
Sektoren der Swap-Datei ist in der Tabelle VM- 
File.slottable abgebildet. Ein Sektor ist entweder 
durch eine Seite belegt und die Nummer der 
Seite in die Tabelle eingetragen, oder der Sektor 
ist frei, was durch einen NULL-Eintrag gekenn- 
zeichnet wird. Soll also eine Seite das erste Mal 
auf die Swap-Datei ausgelagert werden, durch- 
sucht der Swapping-Algorithmus die Belegungs- 
tabelle nach dem ersten NULL-Eintrag und 
schreibt die Handle in den entsprechenden Sek- 
tor. Die Auswahl des »richtigen« Algorithmus zur 
Bestimmung der Seite, die als nächste ausgela- 
gert werden soll, ist dabei natürlich von außer- 
ordentlicher Bedeutung. Wird ein ungeeigneter 
Algorithmus implementiert, kann das dazu füh- 
ren, das ein VMM extrem viel Zeit darauf ver- 
wendet, Seiten ein- und auszulagern. Dieses 
Phänomen wirkt sich stark auf die Effektivität 
der Speicherverwaltung aus und wird als 
»thrashing« bezeichnet. Es tritt z.B. dann auf, 
wenn Seiten ausgelagert werden, auf die sehr oft 
zugegriffen wird. Im VMM ist ein LRU-Algorith- 
mus eingebaut, der die Seite auslagert, auf die 
die längste Zeit nicht zugegriffen wurde. Um 
feststellen zu können, welche Handle das ist, 
wird in der PAGE-Struktur das Zeit-Feld LRU- 
count mitgeführt, das bei jedem Zugriff auf die 
entsprechende Seite aktualisiert wird. Der LRU- 
Algorithmus prüft die Zeit-Felder aller Seiten 
und gibt einen Zeiger auf die Seite zurück, deren 
Kopf den ältesten Zeit-Eintrag enthält. 

Eine mögliche Erweiterung des VMM ist die 
Verwendung einer doppelt verketteten Liste zur 
Verwaltung der freien Speicherblöcke und das 
Mitführen eines Zeigers auf das Ende dieser 
Liste. Wenn auf eine Seite zugegriffen und sie 
gleichzeitig an den Anfang der Liste gehängt 
wird, ist sichergestellt, daß die am längsten nicht 
verwendete Seite immer am Ende zu finden ist. 
Der LRU-Algorithmus muß dann nicht aufwendig 
die Zeit-Einträge aller Seiten überprüfen. Sinn- 
voll wäre auch die Kennzeichnung von Seiten als 
»nonswappable«, so daß sie nicht ausgelagert 
werden können. Das ist z.B. notwendig, wenn 
auch zum Anlegen von Köpfen der VMM benutzt 
wird, nicht die Funktion malloc. In diesem Fall 
muß aber auch das Auslagern von Seiten mit 
Köpfen und anderen, wichtigen Systeminforma- 


tionen unterbunden werden, da sonst der VMM 
seine wichtigsten Werte auslagern und danach 
abstürzen würde. Der LRU-Algorithmus ist relativ 
einfach so zu verändern, daß er besonders ge- 
kennzeichnete Seiten ignoriert und somit nicht 
auslagert. 


Belegungsregeln 


Im allgemeinen unterscheidet man drei Regeln 
zur Einlagerung von Seiteen, je nachdem, ob der 
erste, nächste oder am besten passende Speicher- 
block belegt wird. Das hier verwendete Verfah- 
ren heißt »first fit«, da bei der Suche nach freiem 
Speichern der erste Block, der groß genug ist, 
eine neue Seite aufzunehmen, belegt wird. Da- 
durch wird die Suche in den meisten Fällen kurz. 

Eine Verbesserung dieser Methode bezüglich 
der Anzahl der Suchschritte erreicht man, indem 
man sich die Position der letzten Einlagerung 
merkt und für den nächsten Block an dieser 
Stelle zu suchen beginnt. Darum heißt dieses 
Verfahren auch »next fit« oder »rotating first fit«, 
da Listenende und -anfang zusammengefaßt wer- 
den, also eine Art Ring entsteht. 


Eine dritte, bekannte Einlagerungsregel durch- 
sucht die gesamte Liste der freien Speicher- 
blöcke, um den kleinsten Block zu finden, der ge- 
rade groß genug ist, den einzulagernden aufzu- 
nehmen. Diese Methode bezeichnet man als 
»best fit« und sie bietet den Vorteil, den Spei- 
cherbereich so gut auszunutzen, daß er nicht in 
kleinste Teile zerstückelt wird. Diese Zerstücke- 
lung ist ein großes Problem bei der Auslegung 
einer virtuellen Speicherverwaltung und entsteht 
dadurch, daß der Speicherblock mehr freie Bytes 
besitzt, als beim Einlagern benötigt werden. 
Dann wird nämlich nur ein Teil des Blocks belegt 
und der kleine Rest in die Liste der freien Spei- 
cherblöcke eingetragen. Dann ist es aber vor- 
stellbar, daß dieser Rest zu klein ist, um über- 
haupt noch irgendwann belegt zu werden. Neh- 
men wir z.B. an, daß ein Block mit 24 Bytes 
benötigt und beim Durchsuchen der Liste nur ein 
freier Block mit 32 Bytes gefunden wird. Dann 
werden 24 Bytes von diesem Block belegt und 
die restlichen 8 Bytes gehen in die Liste der 
freien Blöcke (Bild 3). Wenn im weiteren Ablauf 
jeweils Blöcke mit mehr als 8 Byte benötigt wer- 
den, verbleibt der Restblock auf Dauer in der 
Liste. Das Problem besteht darin, daß der VMM 
bei jedem Suchlauf nach freien Blöcken diesen 
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Eintrag prüfen muß, und das führt normaler- 
weise zu einer deutlich verschlechterten Laufzeit. 

Das Problem kann man aber elegant umgehen, 
indem die Größe des angeforderten Speicher- 
blocks auf die nächste Potenz von 2 aufgerundet 
wird. Die Anwendung erhält dann zwar einen 
größeren Speicherblock als sie braucht, aber die 
überzähligen Bytes erscheinen nicht in der Liste 
der freien Blöcke. Im Beispiel würde demnach 
statt eines 24 Byte großen Blocks einer mit 32 
Byte belegt. Die restlichen 8 Byte wären übrig 
und die Liste der freien Speicherblöcke hätte sich 
nicht verändert. 

Eine weitere Lösung des Problems, die wir 
weiter unten ebenfalls betrachten werden, ist das 
Umordnen von freien Speicherblöcken in größere 
Einheiten, das sogenannte »garbage collection«. 


Umwandlung von Handles 
in Speicheradressen 


Wie oben beschrieben, dient eine Handle für den 
VMM lediglich als Referenz auf einen Speicher- 
block, eine Anwendung kann damit nicht auf die 
Adresse des Blocks im Speicher zurückschließen. 
Um auf den Block zugreifen zu können, müssen 
die 32 Bit der Handle, also Handlenummer und 
Offset innerhalb der Seite, in eine Speicher- 
adresse umgewandelt werden. Das leistet die 
Funktion MemDeref. Sie erhält als Argument die 
Handle, teilt sie in Nummer und Offset, sucht 
nach der ID der Seite und lagert diese eventuell 
in den Hauptspeicher ein. Danach wird der Off- 
set auf die Basisadresse der Seite addiert und ein 
Zeiger auf den Block zurückgegeben. 

Zusätzlich wird die Seite an den Anfang der 
verketteten Liste mit aktuellen Seiten gestellt, da 
der VMM davon ausgeht, daß auf sie mehrfach 
hintereinander zugegriffen wird. Das Umverket- 
ten einer erneut verwendeten Seite an den An- 
fang der Liste bringt dann natürlich Zeitvorteile 
bei nachfolgenden Zugriffen, da nicht lange in 
der Liste gesucht werden muß. 

Soll z.B. die Zeichenkette XYZ in den Speicher 
kopiert werden, erreicht man das mit den fol- 
genden Anweisungen: 


#include *"vm.h" 


HANDLE h; 
char far *s; /* ACHTUNG: Large-Speichermodell notwendig */ 


if (Ch = MyAlloc(4)) == (HANDLE) NULL) 
N /* nachfolgende Fehlerbehandlung */ 


if (($ = MenDeref(h)) = NULL) 
strepy (s, "XYZ"); 
Veränderung von Seiten 


Wenn Sie sich im Listing die Funktion WritePage 
genau ansehen, stellen Sie fest, daß eine Seite 


nur dann auf die Platte zurückgeschrieben wird, 
wenn sie sich im Speicherraum befindet und sie 
seit dem Anlegen oder letzten Zurückschreiben 
verändert wurde. Wenn also der Seiteninhalt in 
Swap-Datei und Speicher identisch ist, kann er 
einfach überschrieben werden. Um die Verände- 
rung von Seiten leicht zu erkennen, wird in der 
Struktur PAGE das Bit is dirty mitgeführt. Es 
wird durch die Routine MakePageDirty gesetzt, 
die als Argument die Handle des Speicherblocks 
erhält und damit die zugehörige Seite identifi- 
ziert. Dadurch ist sichergestellt, daß eine verän- 
derte Seite zum Auslagern ordentlich zurückge- 
schrieben wird. Soll z.B. die eben angelegte Zei- 
chenkette XYZ, auf die die Handle h noch immer 
zeigt, in ABC umgewandelt werden, sind fol- 
gende Anweisungen notwendig: 

s = MemDeref(h); 


strepy(s, "ABC*); 
MakePageDirty(h); 


Freigabe von 
Speicherblöcken 


Die Routine MyFree gibt nicht länger benötigte 
Speicherblöcke zur weiteren Benutzung wieder 
frei. Sie erhält als Argument die Handle, fügt den 
Block an die verkettete Liste freier Blöcke an und 
erhöht im Kopf FreeByte um die Anzahl der frei- 
gewordenen Byte. Zusätzlich werden benach- 
barte, freie Speicherblöcke miteinander verbun- 
den und MaxContigFree auf die Anzahl Bytes des 
größten zusammenhängenden Blocks aktuali- 
siert. 

Um das Auffinden benachbarter freier Blöcke 
in der verketteten Liste zu beschleunigen, ist sie 
nach den Offsets der Blöcke sortiert. Dadurch 
muß in der Liste nur nach dem ersten Offset ge- 
sucht werden, der größer ist als der des neu frei- 
gegebenen Blocks. Dieser wird dann davor einge- 
fügt (Bild 4 zeigt ein typisches Zusammenfügen). 


Wenn Block 5 frei 
wird, wird er mit 

».. Block 4 zusammen- 
gezogen (kombi- 
niert). 


Wenn Block 1 frei 


S=mem alloc(32); /* 5 kann z.B. 100 sein */ 


s[ıo] 


erster Pointer 


Dem aufmerksamen Leser ist natürlich schon 
aufgefallen, daß zwar Speicherblöcke von bis zu 
64 Kbyte Größe angefordert werden (maximaler 
Argumentwert der Funktion MyAlloc), die ange- 
legten Blöcke aber die Größe ihrer Seite nicht 
überschreiten können. Um diese Restriktion zu 
umgehen, kann der VMM so verändert werden, 
daß er die Seitengröße dynamisch, d.h. nach An- 
forderung sehr großer Speicherblöcke, erweitert. 


Verwendung 
indirekter Zeiger 


Wie schon erwähnt, reduziert regelmäßiges Zu- 
sammenfügen freier Speicherblöcke die Zerstük- 
kelung des Speicherraums. Vor dem Umordnen 
sind freie und belegte Blöcke vermischt und die 
verkettete Liste muß nach passenden, freien 
Plätzen durchsucht werden. Nach der Umord- 
nung werden alle belegten Blöcke zusammenge- 
packt und auf eine Seite der Handle kopiert, so 
daß ein zusammenhängender Block freien Spei- 
chers auf der anderen Seite der Handle entsteht. 
Wird danach Speicher für einen neuen Block an- 
gefordert, muß nur die Größe dieses freien Rau- 
mes geprüft werden. 

Das größte Problem beim Umpacken entsteht 
dadurch, daß alle Zeiger aktualisiert werden 
müssen, wenn Blöcke im Speicher verschoben 
werden. Das ist für den VMM nicht möglich, da 
er dafür auf Zeiger der Anwendung zugreifen 
müßte. Um die Anpassung der Zeiger zu vermei- 
den, benutzen wir indirekte Zeiger. Diese Metho- 
de ist durch die Verwendung in Speicherverwal- 
tungen sowohl im Macintosh, als auch in Micro- 
soft Windows, bekannt geworden. Wenn also 
eine Anwendung einen Speicherblock benötigt, 
erhält sie nicht einen Zeiger direkt auf den Block, 
sondern einen Zeiger auf einen Zeiger auf den 
Block zurück (Bild 5). 

Bild 6 zeigt die Vorteile von indirekten Zeigern 
beim Umpacken von Blöcken. Die indirekten Zei- 
ger auf Speicherblöcke verändern sich nicht, ob- 
wohl die Blöcke verschoben werden. Da eine 
Anwendung nur diese Art von Zeigern erhält, die 
nicht angepaßt werden, muß der VMM die An- 
wendung bei einer Umpackaktion nicht benach- 
richtigen. Das Verschieben von Blöcken bleibt für 
die Anwendung unsichtbar. (Die Version 2.x von 
Microsoft Windows erlaubt einer Anwendung, 


sich beim Verschieben von Blöcken benachrichti- 
gen zu lassen. Dazu muß lediglich das Flag 
GMEM_NOTIFY im Aufruf von GlobalAlloc ge- 
setzt werden.) 

Aus den Bildern 5 und 6 wird deutlich, daß für 
indirekte Zeiger eine zusätzliche Variable und ein 
zusätzlicher Speicherzugriff notwendig sind, um 
aus einer Handle eine Speicheradresse zu be- 
rechnen. Bei der Geschwindigkeit heutiger CPUs 
sollte das aber kein ernstzunehmendes Problem 
mehr darstellen, vor allem, wenn man die Zeiter- 
sparnis berücksichtigt, die sich ergibt, wenn das 
Durchsuchen der Liste wegfällt. Bedenkt man 
außerdem, daß der Speicherraum nicht mehr 
zerstückelt wird, ist klar, warum die Entwickler 
von Windows indirekte Zeiger benutzen. 


Haupt-Handle- 
Block 


100 
104 
108 
112 


s[ıoo] 


erster Pointer 


S-mem_alloc(32); /* S kann z.B. 100 sein */ 


Der Block auf den die Handle von S zeigt ist verschoben worden, der Wert 
von S selbst bleibt jedoch unverändert. 


Der McBride Allocator 


Zum Schluß sehen wir und noch kurz eine 
andere virtuelle Speicherverwaltung an, VMEM 
von Blake McBride (Tabelle 2). Dieses Produkt 
wird mit vollständigem Quellcode ausgeliefert 
und benutzt ebenfalls indirekte Zeiger, um die 
Leistungsfähigkeit zu erhöhen. VMEM unter- 
stützt zwar bisher nicht Expanded Memory, 
gleicht diesen Nachteil aber dadurch aus, daß die 
Swap-Datei umgepackt werden kann. Außerdem 
benutzt VMEM eine Erweiterung, die schon an- 
gesprochen wurde: die Verwaltung der virtuellen 
Speicherobjekte mittels einer doppelt verketteten 
Liste, so daß ein Zeiger immer auf das am läng- 
sten nicht verwendete Objekt weist. 

Dem Benutzer stehen zwei Methoden zur Ver- 
fügung, die Swap-Datei umzuordnen. Einmal das 
Verschieben aller Objekte an den Anfang der 
Datei, so daß ein großes Loch am Ende der Datei 
entsteht. Dann die Verwendung zweier Dateien: 
Die angelegten Objekte werden aus der ersten in 
eine zweite Swap-Datei kopiert und die erste da- 
nach gelöscht. Obwohl beide Methoden die glei- 
chen Ergebnisse liefern, bietet jede gegenüber 
der anderen einen bestimmten Vorteil. Beim Ver- 
schieben der Objekte innerhalb der Datei wird 
diese nicht komprimiert, bei der Benutzung 
zweier Dateien wird zum Kopieren kurzfristig der 
doppelte Platz auf der Platte belegt. 


44 Bild 5: 
Doppelte 
Verzeigerung. 


“Bild 6: 
Komprimierung mit 
doppelter 
Verzeigerung. 
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» Tabelle 2: 
Routinenaufrufe der 
virtuellen Speicher- 
verwaltung VMEM 
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char far *VM addr(VMPTR_TYPE voh, 

int dirty, int fFreeze) 

Berechnet aus Handle voh die zugehörige Spei- 

cheradresse. Wird der Speicherblock verändert, 

sollte die Variable dirty nicht gleich 0 sein. 
fFreeze muß ungleich O0 sein, wenn der Block 

im Speicher nicht verschoben werden darf. 


VMPTR_TYPE VM alloc(long size, int fClear) 
Belegt einen Speicherblock der Größe size. Wenn 
fClear nicht auf O gesetzt ist, wird der Block mit 
Null überschrieben. 


VM_demps 
Packt die Swap-Datei um. Die gewählte Methode 
wird durch VM_parm bestimmt. 


int VM_dump(char *filename) 

Sichert den aktuellen Stand des virtuellen 
Systems auf die Plattendatei filename und gibt 
eine 0 zurück, wenn die Aktion erfolgreich war. 


void VM end 

Beendet VMEM. Die Swap-Datei wird gelöscht, 
der reale Speicher wird nicht für DOS freigege- 
ben. 


void VM_fcore 
Wie VM_end, aber der reale Speicher wird an 
DOS zurückgegeben. 


void VM free(VMPTR_TYPE voh) 
Gibt das durch Handle voh referierte Objekt frei. 


int VM rest(char *filename) 

int VM frest(char *filename) 

Lädt den durch VM_dump gesicherten Stand des 
virtuellen Systems zurück. VM_rest und VM_frest 
unterscheiden sich im wesentlichen dadurch, daß 
VM rest nur die benötigten Informationen zu- 
rücksichert und damit schneller als VM_frest ar- 
beitet. 


int VM init 
Initialisiert VMEM. 


void VM_parm(long rmmax, long rmasize, 
double rmcompf, long dmmfree, int dmmfblks, 
int dmctype) 

Setzt verschiedene Systemparameter von VMEM: 
rmmax: maximale Größe des von VMEM benutz- 
ten, realen Speichers 

rmasize: minimale Größe des von VMEM benutz- 
ten, realen Speichers 


rmcompf: Kompressionsfaktor des realen Spei- 
chers 

dmmfree: bestimmt das automatische Umpacken 
der Swap-Datei 

dmmfblks: eine andere Methode zur Bestimmung 
des automatischen Umpackens der Swap-Datei 
dmmctype: Art des Umpackens der Swap-Datei. 


VMPTR_TYPE VM_realloc(VMPTR_TYPE voh, 

long newsize) 

Belegt einen durch die Handle voh referierten 
Speicherblock neu und gibt ein Handle darauf 
zurück. 


long *VM stat 
Gibt verschiedene Werte des aktuellen System- 
status zurück. 


Zusätzlich dazu ermöglicht VMEM das Sichern 
und Zurückladen eines Abbilds des gesamten vir- 
tuellen Speichers, z.B. um den aktuellen Stand 
des Systems abzulegen, den Speicher an DOS 
freizugeben, ein weiteres Programm ablaufen zu 
lassen (etwa einen Compiler) und danach in der 
ersten Anwendung mit dem virtuellen Speicher 
weiterzuarbeiten, nachdem der gesicherte Stand 
wieder hergestellt wurde. 

Beim genauen Hinsehen zeigt sich auch, daß 
das VMEM API etwas mehr Kontrolle über die 
Steuerparameter zuläßt, als es mit unserem 
VMM möglich ist. VMEM kann angegeben wer- 
den, ob er beim Anlegen neuer Blöcke Speicher 
löschen oder das Dirty-Bit beim Freigeben von 
Blöcken setzen soll. Außerdem können wesent- 
liche Steuerparameter direkt verändert werden. 

Die Verwendung einer virtuellen Speicherver- 
waltung als Ersatz für Speicher aus dem Heap 
ermöglicht einer Anwendung, flexibler mit 
großen Datenmengen zu operieren. Am Besten 
wäre es, virtuellen Speicher auf Betriebssystem- 
Ebene zu verwalten und Anwendungen auf höhe- 
rem Niveau völlig davon abzutrennen, wie es z.B. 
Microsoft OS/2 verwirklicht. Da aber ein großer 
Teil des Marktes auch noch in naher Zukunft fest 
in der DOS-Welt verankert sein wird, sind virtu- 
elle Speicherverwaltungen auf Anwendungs- 
ebene notwendig. 

In Zukunft werden in allen Betriebssystemen 
virtuelle Speicherkonzepte implementiert sein, 
die dedizierte Chips zur Speicherverwaltung nut- 
zen, wie sie schon jetzt von Intel und Motorola 
erhältlich sind. Hoffentlich dauert es bis dahin 
nicht mehr allzulang. 

Marc Adler 


a / 


/* Virtual Memory Manager VM.H */ 
I* # 
/* (C) Copyright 1988 Marc Adler/Magma Systems-All Rights Reserved*/ 
Piel # 
/* This software is for personal use only, and may not be used in */ 
/* any commercial product, nor may it be sold in any way. */ 
2 IR 
| 
#define NO 0 

#define YES 1 

#define MAXSLOTS 1024 

#define PAGESIZE 4096 


#define EMM_PAGESIZE 16384 
#define MAXPATHLEN 65 


typedef unsigned PAGEID; 
typedef unsigned long HANDLE; 


Ir 
The page header .... 

“/ 

typedef struct page 

{ 
struct page "next; /* chain to next free page in list */ 
char far *memaddr; /* memory address of the page block */ 
unsigned long diskaddr; /* disk address of the page block */ 
PAGEID id; /* page identifier */ 
unsigned long LRUcount; /* least-recentiy-used count “ 
unsigned pagesize; /* how many bytes is this page #, 
unsigned freebyte; /* index of Ist free byte in page */ 
unsigned bytesfree; /* # of bytes free in this page */ 
unsigned maxcontigfree; /* max # of contiguous free bytes */ 


unsigned flags; 

#define PAGE_IN MEM 0x0001 
#define PAGE_ON DISK 0x0002 
#define 15_DIRTY 0x0004 
#define SET_PAGE_DIRTY(p) 
#define NON_SWAPPABLE 0x0008 
#define PAGE_IN_EMM 0x0010 
} PAGE; 


({p)->flags |= IS_DIRTY) 


typedef struct disktable 


{ 

#define SECTOR_FREE ((PAGE *) NULL) 
PAGE *page; 

} PAGE_DISK_ENTRY; 


/*® 
The free block header ..... 
u 4 
typedef struct freeinfo 
{ 
unsigned nextfree; /* offset of next free entry (OxFFFF at end) */ 


#define FREELIST_END OxFFFF 


unsigned bytesfree; /* # of bytes in this chunk */ 
} FREEINFO; 


I* 
This contains info about the swap file... 
. 
/ 
typedef struct wmfile 
{ 
char filename[MAXPATHLEN] ; /* name of the VM file */ 
int fd; /* file handle to the VM file */ 
PAGE_DISK_ENTRY slottable[MAXSLOTS]; 
} VMFILE; 


/* External declarations */ 
extern char WMInitialized; 
extern unsigned TotalPages; 
extern PAGE *Pagelist; 
extern VMFILE VMFile; 
extern unsigned VMPageSize; 


/"global*/ int VMInit(void); 

/*global*/ int VMTerminate(void); 

/*global*/ char *AllocPageText(struct page *, unsigned int ); 
/*global*/ struct page *AllocPage(void); 

/*global*/ int ReadPage(struct page *); 

/*global*/ int Writepage(struct page *); 

/*global*/ int SwapoutPage(struct page *,int ); 

/*global*/ int Swapinpage(struct page *); 

/*global*/ struct page *FindLRUPage (void); 

/*global*/ int FindSlotFree(void); 

/*global*/ HANDLE MyAlloc(unsigned int ); 

/*global*/ void MyFree(HANDLE); 

/*global*/ struct page *FindNBytesfree(unsigned int ); 
/*global*/ struct page *FindNContigBytesFree(unsigned int ); 
/*global*/ int CompactifyPage(struct page *); 

/*global*/ char far *MemDeref(HANDLE); 

/*global*/ PAGE *PageDeref(HANDLE); 

/*global*/ char *mymalloc(unsigned); 


| 


/* Virtual Memory Manager m.c “ 
f% ”/ 
/* (C) Copyright 1988 Marc Adler/Magma Systems-All Rights Reserved */ 
ie “ 
/* This software is for personal use only, and may not be used in */ 
/* any commercial product, nor may it sold in any way. “f 
I* “7 


JoRrBe ee 


#include <stdio.h> 
#include <stdlib.h> 
#include <dos.h> 
#include <malloc.h> 
#include <fcntl.h> 
#include <io.h> 
#include <sys\types.h> 
#include <sys\stat.h> 
#include "vm.h" 


/* macro to return a ptr to a freeinfo structure */ 
#define FREEPTR(pg, offset) (FREEINFO *) (pg->memaddr + offset) 


/* Total # of pages allocated */ 

/* TRUE if the VMM has be initialized */ 
PAGE *PageList = NULL; /* Linked list of pages */ 

VMFILE VMFile; /* mM File info */ 

unsigned VMPageSize = PAGESIZE; /* Pagesize of a WM block */ 
unsigned long LRUcIock = 0; /* Clock used for LRU swapping */ 
unsigned Emergency = NO; /* TRUE if 005 has no more memory */ 


unsigned TotalPages = 0; 
char VWMinitialized = NO; 


/* NMInit 
Initialize the Virtual Memory Manager (VMM). 

ed 
YMInit() 
{ 

char *mktemp(); 

char *pascal strend(); 

int i; 

char *tempdir; 


I* 
Create the VM swap file. Try to use the path specified in the 
METEMP environment variable. If METEMP was not specified, use 
the current directory. 

wi 

VMFile.filename[0] = '\0'; 

if ((tempdir = getenv("METEMP")) != NULL) 

{ 
char *end = strend(strepy(VMFile.filename, tempdir)); 
if (end[-1) t= "\\') /* add the backslash */ 
{ 


*end = '\\'; 
*+Hend = '\0'; 
} 
} 


strcat(VMFile.filename, mktemp("VMXXXXXX")); 
if ((VMFile.fd = open(VMFile,filename, 
O_RDWR|O_TRUNC|O_CREAT|O_BINARY, 
SZIWRITE]S_IREAD)) < 0) 
{ 
err("VMM — Cannot initialize VM system"); , 
die(-1); 
} 


for (i = 0; i < MAXSLOTS; i++) 
VMFile.slottable[i].page = NULL; 


VMinitialized = YES; 
return 0; 


} 


/* \MTerminate 
Close and delete the VM swap file. 

“ 

/ 
VMTerminate() 
{ 

if (VMInitialized) 

{ 


close(VMfile.fd); 
unlink({VMFile.filename); 
VMinitialized = NO; 
} 
} 


/* MemDeref 
main routine for dereferencing a VM handle. 

“ 

/ 
char far *MemDeref(h) 

HANDLE h; 
{ 

int pid, offset; 

PAGE *p, *prevp; 


/* Separate the handle into the page id 
and the offset within that page */ 


44 Listing 2: 
VM.H 


«Listing 3: 
VM.C 
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pid = (int) ((h >> 16) & Ox0000FFFF); 
offset = (int) (h & Ox0000FFFF); 


/* Search the linked list of pages for 
the page with id 'pid'. */ 


for (prevp=p=Pagelist; p && p>id I= pid; prevp=p, p=p->next) 


if (!p) 
return (HANDLE) NULL; 


/* If the page is not in conventional memory, swap it in, */ 
if (I{p->flags & PAGE_IN_MEM)) 
SwapinPage(p); 


/* Update the LRU count and bring the 
page to the front of the pagelist */ 


p->LRUcount = LRUclock+t+; 
if (p != PageList) 
{ 


prevp->next = p>next; 
p>next = Pagelist; 
Pagelist = p; 

} 


/* Return the absolute address which the handle references. */ 
return p->memaddr + offset; 


MakePageDirty(h) 
HANDLE h; 


PAGE *p; 
if ((p = PageDeref(h)) I= NULL) 
SET_PAGE_DIRTY(p); 
} 


PAGE *PageDeref (h) 
HANDLE h; 

{ 
int pid, offset; 
PAGE *p; 


/* Separate the handle into the page id 
and the offset within that page */ 


pid = (int) ((h >> 16) & OxO000FFFF); 
offset = (int) (h & 0x0000FFFF); 


/* Search the linked list of pages for the page with id 'pid'. */ 
for (p = Pagelist; p Ah p->id != pid; p = p->next) 


return p; 


/* AllocPage 
Allocates a new page and links it to the page list. 


PAGE *AllocPage() 
{ 


PAGE *p; 
char *s; 
FREEINFO *f; 


/* Make sure that the VMM is ready. */ 
if (1VMInitialized) 
YMInit(); 


/* Allocate the page structure from the heap */ 
if ((p = (PAGE *) calloc(sizeof(PAGE), 1)) == NULL) 
return NULL; 


/* Allocate the page's text buffer from D0S or EMM */ 
if ((s = AllocPageText(p, VMPageSize)) == NULL) 
return NULL; 


/* Fill the page structure. */ 


p>memaddr "5; 

p>flags |= PAGE_IN_MEM; 
p->id = ++TotalPages; 
p>LRUcount = LRUclock++; 


p>pagesize = VMPageSize; 
p->freebyte =0; 

p->bytesfree = VMPageSize; 
p->maxcontigfree = VMPageSize; 


” 
{ Set up the page's initial free node. 
p memaddr 
| freebyte | 0 |—> I|nextfree |-1 | 
| bytesfreeläK | 

Hl 


|bytesfreejak | 


/ 


f = (FREEINFO *) s; 
f>bytesfree = VWMPageSize; 
f-nextfree = FREELIST_END; 


/* Link the page to the head of the pagelist. */ 
p->next = Pagelist; 
Pagelist = p; 


return p; 


* AllocPageText 
* Allocs a block of 'size' bytes to be used as the page's buffer. 
I 


char far *AllocPageText (page, size) 


/ 


PAGE *page; 
unsigned size; 


PAGE *p; 
char far *s; 


/* Use DOSALLOC() to allocate the 4K page buffer */ 
while ((s = mymalloc(size)) == NULL /* || test_swap */) 


/* Swap out the Least Recently Used page. 
Return the LRU page ptr. */ 


if (({p = FindLRUPage()) == NULL) 
{ 


err("VMM — FindLRUPage() can't find a page to swap"); 
return NULL; 
} 


/* Use the swapped-out page's text buffer as the new buffer. */ 
s = p->memaddr; 

SwapoutPage(p, NO); 

memset(s, 0, size); 

break; 


} 


return $; 


“ 

ReadPage() 

This is called from MemDeref() when the referenced page is not in 
conventional memory. 

If the page is already in memory, then just return; 


Seek to the disk address and read the proper number of bytes 
mark the page as being in memory 


/ 


ReadPage(p) 


{ 


} 


PAGE *p; 
char *s; 
if (p>flags & PAGE_ON DISK) 


/* Obtain a text buffer which the 
swapped page will be read into. */ 


if ((s = AllocPageText(p, p>pagesize)) == NULL) 
return -1; 


/* Seek to the proper place and read the page. */ 
Iseek(VMFile.fd, (long) (p->pagesize * p->diskaddr), 0); 
if (read(VMFile.fd, p->memaddr = s, p->pagesize) I= p->pagesize) 
{ 

err("FATAL ERROR! read() failed in ReadPage()"); 

die(-1); 
} 


/* Say that the page is now in conventional 
memory as well as on disk. */ 


p->flags |= PAGE_IN_MEM; 
p>LRUcount = LRUClockt+; 
} 


return 0; 


/* 


WritePage() 


If the page is on disk or it's in memory and there 
is a copy out on disk and the page isn't dirty return 


Find a free sector in the VM file 

Seek to the free sector and write the page 

Clear the dirty bit 

make an entry in the page/disk table and put the page in there 


5 


WritePage(p) 
PAGE *p; 
{ 


unsigned sector; 


/* If the page is not in memory, then don't write it to disk */ 
if (I(p>flags & PAGE_IN MEN) 
return 0; 


/* The page has a disk sector allocated to it already */ 
if ((p>flags & PAGE_ON_DISK) 88 !(p->flags & IS_DIRTY)) 
return 0; /* the in-mem copy is the same as the copy on disk */ 


if ((sector = FindSlotFree()) == OxFFFF) 
{ 


err("VMM — No more slots free."); 
return -1; 


! 


/* See to the sector and dump the page text. */ 
Iseek(VMFile.fd, (long) (sector * (long) p->pagesize), 0); 
if (write(VMFile.fd, p->memaddr, p->pagesize) != p->pagesize) 
l 


err("FATAL ERROR! write() failed in WritePage()*); 
exit(-1); 
} 


VMFile.slottable[sector].page = p; 
p->diskaddr = (long) sector; 
p->flags |= PAGE_ON_DISK; 
p->flags &= “IS_DIRTY; 

p->LRUcount = LRUclock++; 


SwapOutAllPages() 
l 


PAGE *p; 
for (p = Pagelist; p; p = p->next) 
SwapoutPage(p, YES); 


/* 
This is called from AllocPageText() when there 
is no more D0S memory free and no more Expanded 
memory free to allocate a page. 

“7 


SwapoutPage(p, free_it) 
PAGE *p; 
{ 
WritePage(p); 
if (free_it) 
{ 


if (p->flags & PAGE_IN_MEM) 
my_free(p->memaddr) ; 


p->flags &= "PAGE_IN_MEM; 


SwapInAllPages() 
( 


PAGE *p; 
for (p = Pagelist; p; Pp = p->next) 
SwapinPage(p); 


SwapinPage(p) 
PAGE *p; 

{ 
ReadPage(p); 


Ir 

FindLRUPage 

Finds the Least Recently Used page and returns a pointer to it. 
er 


PAGE *FindLRUPage() 
{ 
PAGE *p; 
PAGE *retp = NULL; 
unsigned long minLRU = OxFFFFFFFF; 


for (p = Pagelist; p; p = p->next) 


if ((p->flags & PAGE_IN_MEM) && 


p->LRUcount <= minLRU) /* && IS_SWAPPABLE */ 
I 


retp = p; 
minLRU = p->LRUcount; 
} 
} 
return retp; 
} 


Listing 3: 
Ir Fortsetzung 
FindSlotFfree 
returns the first unused entry in VMFile.slottable 
FindSlotFree() 
{ 
register int i; 


for (i = 0; i < MAXSLOTS; i++) 
if (VMFile.slottable[i].page == NULL) 
return i; 
return -1; 
} 


F Auiihishehaiuieiuiuhehehuhehehaiuhababeischabuhuhe iii ehe ri; ern] 
or “/ 
f* Routines to allocate mem from a page u 
ad */ 


/ 


/* 
MyAlloc(n) 


We want to allocate n bytes from the system. 


Make sure that n is less than VMPageSize. 
Make sure that n is a mutiple of 8. 


Find a page which has a contiguous block of n 
bytes free. Give preference to a page which is 
already in memory. 


If a page has n bytes free but not contiguous, 
then we will do compaction on the page. 


If there is still no page with n bytes free, 
then allocate a new page. 


At this point, we have a page 'p' with at least 
n bytes free. 


Decrease the bytes-free count of the page. 
Link the unallocated bytes onto the page's free list. 
Update the MaxContiguousFree count of the page. 


Return the Page/Offset value to the caller. 
“ 
/ 


HANDLE MyAlloc(needed) 
unsigned needed; 
{ 
FREEINFO *f, *prevf, *newf; 
PAGE *p, *FindNBytesFree(); 
unsigned offset, bytes_needed, bytes_left; 
unsigned maxcontig, new_offset; 
HANDLE h; 


needed = (needed + sizeof(FREEINFO)); 
if (needed <= 0 || needed > VMPageSize) 


{ 
return (HANDLE) NULL; 
} 


/* Return a page that has at least 'needed' bytes free */ 
if ((p = FindNContigBytesfree(needed)) == NULL) 
return (HANDLE) NULL; 


/* Traverse the list of free chunks in 
the page and find the first */ 


/* chunk with 'needed' bytes free. 'F' 
will be the addr of the chunk. */ 


maxcontig = 0; 
offset = p->freebyte; 


for (f = (FREEINFO *) (p->memaddr + p->freebyte); 
f->bytesfree < needed; 
f = (FREEINFO *) (p->memaddr + offset)) 


( 
prevf = f;_ /* save ptr to previous chunk for linking */ 
if ((offset = f->nextfree) == FREELIST_END) 


/* If we get here, then there is not 'needed' 
contiguous bytes free */ 


return (HANDLE) NULL; 
maxcontig = max(maxcontig, f->bytesfree); 


} 


/* Unlink and relink f (make sure there 
is enough room for the link) */ 


bytes_left = f->bytesfree — needed; 
if (bytes_left <= sizeof(FREEINFO)) /* less than 4 
bytes remaining? */ 
l 
needed = f->bytesfree; /* no room for the link — */ 
bytes_left = 0; /* alloc the whole thing */ 
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Ir 
If the chunk that we are allocating is smaller than the 
page's biggest free chunk, then there should be no change 
to the max. We set maxcontig equal to the page's maxcontig 
so that we won't traverse the rest of the free chain below. 
* 
/ 


if (f-bytesfree < p->maxcontigfree) 
maxcontig = p->maxcontigfree; 


if (bytes_left == 0) 
{ /* We allocate the entire chunk */ 
if (offset == p>freebyte) /* The chunk is the Ist free one */ 
p->freebyte = f->nextfree; /* so, relink the head pointer. */ 
else 
prevf->nextfree = f->nextfree; 
new_offset = f->nextfree; 
} 


else /* if (bytes_left) */ 
{ /* There is some space left over in the chunk */ 
if (offset == p->freebyte) 
p->freebyte = offset + needed; 
else 
prevf->nextfree = offset + needed; 
/* Create a new chunk from the remaining bytes */ 
newf = (FREEINFO *) (p->memaddr + offset + needed); 
newf—>nextfree = f->nextfree; 
newf->bytesfree = bytes left; 
maxcontig = max(maxcontig, newf->bytesfree); 
new_offset = offset + needed; 
} 


/* Now we traverse the rest of the freelist looking for a chunk */ 
/* with more bytes free than maxcontig. “/ 
if (maxcontig < p->maxcontigfree && new_offset I= FREELIST_END) 
{ 
FREEINFO *f2; 
for (f2 = (FREEINFO *) (p->memaddr + new_offset); 
f2->bytesfree < p->maxcontigfree; 
f2 = (FREEINFO *) (p->memaddr + new_offset)) 
if ((new_offset = f2->nextfree) == FREELIST_END) 
break; 
maxcontig = max(maxcontig, f2->bytesfree); 


} 


p->bytesfree -= needed; /* decrease # of free bytes in the page */ 
p->maxcontigfree = maxcontig; 
f-bytesfree = needed; /* set the length field 

in the returned chunk */ 


/* Relink the previous */ 
/* chunk to next w 


/* Clear the allocated memory to zeroes */ 
memset (p->memaddr + offset + sizeof(FREEINFO), 
’\0', needed-sizeof(FREEINFO)); 


/* Return offset */ 

h = (HANDLE) (((long) p->id) << 16) | 
(long) (offset + sizeof(FREEINFO)); 

return h; 


} 


/* Return a pointer to a page with N bytes free */ 
PAGE *FindNContigBytesFree(needed) 

unsigned needed; /* # of bytes needed */ 
{ 

PAGE *diskpage = NULL; 

PAGE *p; 


I" 
Traverse the page list looking for a page with the needed 
amount of bytes free in one contiguous chunk. 

. 

/ 

for (p = Pagelist; p; p = p>next) 

{ 


if (p->maxcontigfree >= needed) 
{ 
if (p->flags & PAGE_IN_MEN) 
{ /* If the page is in memory, then return it immediately */ 
return p; 


} 
else if (p->flags & PAGE_ON DISK) 
{ /* If the page is on disk, then mark it as the candidate */ 
if (!diskpage) diskpage = p; 
} 
} 
} 


jr 
At this point, we have no memory-based page with 
n contiguous bytes, and possibly a disk-based page 
with n contiguous bytes. 

= 


if (diskpage) 
{ 


SwapinPage(diskpage); 
CompactifyPage(diskpage); 
return diskpage; 

} 

else 


{ 
/* No disk page had the needed bytes!!! 
Try to allocate a new page! */ 


return AllocPage(); 
} 
} 


CompactifyPage(p) 
PAGE *p; 
{ 
/* 
This routine has nothing in it yet.... Maybe one day, 
we']l add compaction.... 
st 
} 


void MyFree(h) 
HANDLE h; 
{ 
char *s; 
int pid; 
PAGE *pg; 
FREEINFO *f, *hFree, *prevf; 
unsigned fOffset, höffset, prevfüffset; 


/* Swap the page in if necessary */ 
if ({s = MemDeref(h)) == NULL) 
return; 


pid = (int) ((h >> 16) & 0x0000FFFF); 

höffset = (int) (h & Ox0000FFFF); 

hoffset —= sizeof(FREEINFO); 

for (pg = Pagelist; pg && pg->id != pid; pg = pg>next) ; 
SET_PAGE_DIRTY(pg); 


hFree = FREEPTR(pg, hOffset); 
pg->bytesfree += hFree>bytesfree; 


/* See if we have an empty free list */ 
if (pg>freebyte >= pg->pagesize) 
{ 


j# 
pg h 

freebyte—nextfree —X 
* 
/ 
pg>freebyte = hüffset; 
pg->maxcontigfree = hFree->bytesfree; 
hFree->nextfree = FREELIST_END; 
return; 


} 


/* Traverse free chain until we get a free chunk whose address */ 
/* is larger than the address of the chunk about to be freed. */ 
for (f = FREEPTR(pg, (fOffset = pg->freebyte)); 

höffset > fOffset &4 f->nextfree != FREELIST_END; 

prevfüffset=fOffset, prevf=f, 

f = FREEPTR(pg, (füffset = f->nextfree))) 


/* See if we should insert the new chunk after the tail */ 
/* 


100 200 
f h 
nextfree—>nextfree—>X 


Ar 
if (höffset > fOffset) /* we got here cause we hit the end */ 


/* Try to combine chunks f and h */ 
if (fOffset + f->bytesfree == hOffset) 
{ 
f->bytesfree += hFree>bytesfree; 
/* We should examine the block after f for coalescing */ 
} 
else /* Can't combine */ 
{ 
hFree->nextfree = FREELIST_END; 
f-nextfree = höffset; 
/* We should examine the block after h for coalescing */ 
set_f_to_h: 
f = hfree; 
foffset = hOffset; 
pg->maxcontigfree = max(pg->maxcontigfree, hfFree->bytesfree); 
} 
} 


/* See if we should insert before the first free chunk */ 
else if (pg->freebyte == fOffset) 


{ 
I* 
p9->freebyte = 300 
200 300 
h——— of 
* 


Bei PC-Software setzen wir weltweit den Standard. Microsoft- 


Produkte stehen für Leistung und Benutzerfreundlichkeit. 
Einige Beispiele: die Betriebssysteme MS-DOS und MS OS/2, 
die Textverarbeitung MICROSOFT WORD oder die WINDOWS- 
Applikation MICROSOFT EXCEL. 

Für die verantwortliche Betreuung des Microsoft System 
Journals, der deutschen Zeitschrift für professionelle System- 
entwickler und Programmierer, suchen wir jetzt den/die 


TECHNISCHEN REDAKTEUR/IN 


Sie sind zuständig für die journalistische Aufbereitung der in 
unseren technischen Abteilungen vorhandenen Informationen 


für die Fachöffentlichkeit. 


Wir sind ein moder- 
nes und innovatives 
Unternehmen. Als 
deutsche Tochter 
des Weltmarktfüh- 
rers für hochwerti- 
ge System- und Ap- 
plikationssoftware 
im PC-Bereich ver- 
zeichnen wir jährlich 
überdurchschnittli- 
che Zuwachsraten. 
Unser Arbeitsstil ist 
kooperativ und lei- 
stungsorientiert. 
Kreativität und Ein- 
satzfreude eröffnen 
unseren Mitarbei- 
tern vielseitige Ent- 
wicklungsmöglich- 
keiten und sichern 
den gemeinsamen 
Erfolg. 


Im wesentlichen bestehen Ihre 
Aufgaben in der Kooperation mit einer unab- 
hängigen externen Redaktion, Zusammenarbeit 
mit einem unabhängigen Verlagshaus sowie der 
Planung und verantwortlichen Durchführung von 
Marketingaktionen zur Markteinführung und 
-durchsetzung der Zeitschrift. Darüber hinaus 
werden Sie weitere interne Medien verant- 
wortlich betreuen. 

Sie sollten hierfür möglichst ein Studium der 
Kommunikationswissenschaft oder BWL/Wirt- 
schaftsinformatik mitbringen und mindestens ein 
Jahr Redaktionserfahrung in einer Zeitschrift, 
einem Zeitschriftenvolontariat oder mehrjährige 
Erfahrung als Freelancer für die elektronische 
Fachpresse erworben haben. Außerdem erwarten 
wir intensive Programmiererfahrung mit einem 
Microsoft/Compiler sowie zusätzliche Grund- 
kenntnisse in C, MASM oder Pascal. 
Selbstverständlich für uns ist eine gute „Schreibe” 
und die damit verbundene Fähigkeit, komplexe 
Themen klar und verständlich auszudrücken. 

Der Reiz dieser Aufgabe liegt in der verant- 


wortlichen Tätigkeit für eine Zeitschrift mit Alleinstellungsmerk- 
malen auf dem Mediamarkt sowie in der Chance, kreative eigene 
Ideen in der Gründungsphase einer neuen Zeitschrift *einzu- 
bringen. Sie selbst zeichnen sich durch selbstsicheres, kom- 
munikatives Auftreten aus und bringen Selbständigkeit, Team- 
fähigkeit, Kreativität sowie sehr gutes Englisch mit. 

Wenn Sie in dieser Position die konsequente Fortsetzung Ihrer 
Karriere sehen, schicken Sie bitte Ihre aussagefähigen Bewer- 
bungsunterlagen an: 


Microsoft GmbH, Personalabteilung, 
Edisonstraße 1, 8044 Unterschleißheim 


ZUKUNFT DER SOFTWARE 


Listing 3: 

hFree->nextfree = füffset; Ende 

pg->freebyte = höffset; 

/* We should examine the block after h for 
coalescing */ 

goto set_f_to_h; 


/* We must be inserting between two existing 
free chunks */ 
else 
{ 
I* 
100 200 300 
prevf h f 
nextfree—>nextfree—>nextfree—> 
* 
/ 
/* See if we can coalesce prevf and h */ 
if (prevfOffset + prevf->bytesfree == 
hoffset) 
{ 
prevf->bytesfree += hFree->bytesfree; 
/* We should examine the block after prevf 
for coalescing */ 
f = prevf; 
füffset = prevfüffset; 
pg->maxcontigfree = max(pg->maxcontigfree, 
prevf->bytesfree); 
} 


else 

{ 
hFree->nextfree = prevf->nextfree; 
prevf->nextfree = hüffset; 
/* We should examine the block after 

h for coalescing */ 

goto set_f_to_h; 

} 

} 


/* We want to examine the block after 
chunk f to see if we can coalesce */ 


if (f->nextfree I= FREELIST_END && 
fOffset + f-bytesfree == f->nextfree) 
{ 
hFree = FREEPTR(pg, f->nextfree); 
fnextfree = hFree->nextfree; 
f->bytesfree += hFree->bytesfree; 
pg->maxcontigfree = max(pg->maxcontigfree, 
f->bytesfree); 


char far *mymalloc(size) 
unsigned int size; 

{ 
char *s; 
unsigned seg; 
unsigned paras; 


/* We know that we have no DOS memory left */ 
if (Emergency) 
return NULL; 


/* Convert bytes to paragraphs */ 
paras = (size + 15) > 4; 


/* Let D0S to do the allocation */ 
if (_dos_allocmem(paras, äseg) != 0) 
{ 

Emergencyt++; 

return NULL; 
} 


Ir 
Convert the alocated memory into a far 


address and clear it out 
Br 


FP_SEG(s) = seg; 
FP_OFF(s) = 0; 

memset(s, 0, paras << 4); 
retum s; 


my_free(s) 
char far *s; 
{ 
/* The memory must be returned to 005 */ 
_dos_freemem(FP_SEG(s)); 
Emergency = FALSE; 
/* we can alloc some more DOS memory */ 


| SetVMPageSize(kbytes) 


int kbytes; 


VMPageSize = (unsigned) kbytes * 1024; 


1) 
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Eine komfortable Benutzer- 
oberfläche in C (Teil 5): 


Erstellung und 
Verwaltung 
von SAA- 
Dialogboxen 


Dialogboxen - dieser Begriff steht 
als Synonym für die Art und 
Weise, wie SAA-Applikationen 
Daten vom Anwender über Tasta- 
tur und Maus empfangen. Und da 
auch PCs im wesentlichen nichts 
anderes als Datenverarbeitungs- 
anlagen sind, kommt den Dialog- 
boxen als Teil des SAA-Konzepts 
naturgemäß eine große Bedeutung 
zu. Grund genug, auch diesen Be- 
standteil des weit gefächerten 
SAA-Konzepts im Rahmen unserer 
SAA-Serie genauer unter die Lupe 
zu nehmen und eine mögliche Um- 
setzung in C vorzuführen. 


enn Sie diese Serie und damit unseren 
Streifzug durch die SAA-Welt schon ein 
wenig länger verfolgen und sich an die bisheri- 
gen Folgen zurückerinnern, werden Sie fest- 
stellen, daß wir in jeder Folge einen Aspekt des 
SAA-Konzepts in den Mittelpunkt gestellt haben. 

Galt unser Interesse zunächst den Basismodu- 
len zur Bildschirmausgabe sowie zur Abfrage von 
Maus und Tastatur, folgte darauf die Pull-Down- 
Menüverwaltung, die bereits eines der überge- 
ordneten SAA-Module darstellt. Ihr schloß sich in 
der letzten Ausgabe des Microsoft System Jour- 
nals eine Help-Engine an, die Ihnen die Erstel- 
lung und Einbindung von Help-Texten in Ihre 
Applikationen auf leichte Art und Weise ermög- 
licht. 

Nun also geht es um die SAA-Dialogverwal- 
tung und auch die Module, die ich Ihnen in die- 
ser Folge vorstellen möchte, zählen zu den über- 
geordneten SAA-Modulen. Wie die Pull-Down- 
Menüverwaltung und die Help-Engine, stehen 
auch diese Module ganz im Zeichen größtmög- 
licher Benutzerfreundlichkeit — einer Forderung, 
die eines der primären Ziele der SAA-Initiative 
charakterisiert. 

Im Gegensatz zu den vorgenannten Modulen 
läßt sich eine komplette SAA-Dialogverwaltung 
jedoch nicht auf den knapp 20 Seiten realisieren, 
die uns in jeder Folge des System Journal zur 
Verfügung stehen. Deshalb beschäftigt sich nicht 
nur diese, sondern auch die kommenden Folgen 
unserer SAA-Serie mit der SAA-Dialogverwal- 
tung, deren Konzeption — wie Sie gleich feststel- 
len werden — einer Aufteilung in relativ unab- 
hängige Module sogar entgegenkommt. 


Was bitte sind Dialogboxen? 


Bild 1 zeigt eine typische SAA-Dialogbox, wie 
man sie in den SAA-Applikationen MS-Works, 
QuickC 2.0, Quick Pascal oder beispielsweise in 
der DOS-Shell von DOS 4.0 vorfindet. 

Eine Dialogbox erscheint nach der Auswahl ei- 
nes Kommandos aus der Befehlsleiste als Fenster, 
das über dem Arbeitsbereich der SAA-Applika- 
tion geöffnet wird. Innerhalb dieses Fensters, das 
von einem einfachen Rahmen umgeben wird, be- 
finden sich die einzelnen Dialog-Felder, auch 
Dialog-Objekte oder nur Objekte genannt. 
(Woher der Name stammt, der doch so verdäch- 
tig an die im Augenblick heiß diskutierte objekt- 
orientierte Programmierweise erinnert, wird am 
Ende dieses Artikels noch zur Sprache kommen.) 

Logisch zusammenhängende Objekte werden 
dabei räumlich zusammengefaßt und ihre Zu- 
sammengehörigkeit nicht selten durch einen sie 
umgebenden Rahmen gegenüber dem Anwender 
verdeutlicht. Oft enthält dieser Rahmen einen 
Titel, der in der Mitte des Rahmens zentriert 
wird und den Oberbegriff angibt, unter dem die 
einzelnen Felder stehen. 


Der Anwender kann Eingaben innerhalb der 
einzelnen Objekte in beliebiger Reihenfolge vor- 
nehmen, indem er sich mit Hilfe der Tasten Tab 
und Shift-Tab zwischen den einzelnen Objekten 
hin- und herbewegt. Das jeweils aktuelle Objekt, 
also das Objekt, auf das sich seine Eingaben be- 
ziehen, wird farblich hervorgehoben und da- 
durch deutlich sichtbar gemacht. 

Aber auch die Maus kann selbstverständlich in 
die Bearbeitung einer Dialogbox einbezogen 
werden und oft gestaltet sich die Dateneingabe 
mit Hilfe der Maus einfacher, als nur mit Hilfe 
der Tastatur. Die Maus nämlich erlaubt bei- 
spielsweise die Anwahl eines Objekts, indem das 
Objekt einfach angeklickt, der Maus-Cursor also 
auf das Objekt bewegt und der linke Mausknopf 
dann kurzzeitig niedergedrückt und wieder los- 
gelassen wird. 

Aber auch bei der Dateneingabe innerhalb der 
einzelnen Objekte vermag die Maus wertvolle 
Dienste zu leisten, was im folgenden bei der Be- 
schreibung der einzelnen Objekte noch deutlich 
werden wird. 

Darüber hinaus helfen auch die sogenannten 
»Hotkeys« bei der Auswahl der Objekte weiter. 
Analog zu den Hotkeys, die im Rahmen der Pull- 
Down-Menüverwaltung vorgestellt wurden, ver- 
fügt jedes Objekt über einen individuellen Hot- 
key. Die Betätigung des jeweils farblich hervor- 
gehobenen Hotkeys — eines Buchstabens oder 
einer Zahl - in Verbindung mit der Alt-Taste, 
führt zur Aktivierung des zugehörigen Objekts. 


Vielfalt der Objekte 


Wie jede Programmiersprache unterschiedliche 
Datentypen bereitstellt, um unterschiedliche Ar- 
ten von Informationen erfassen und verarbeiten 
zu können, so kennt der SAA-Standard auch ver- 
schiedene Arten von Dialog-Objekten, die dem 
unterschiedlichen Charakter zu verarbeitender 
Informationen gerecht werden. Und wie jedes 
Programm eine (nahezu) beliebige Anzahl von 
Variablen eines bestimmten Typs beinhalten 
kann, so kann eine Dialog-Box auch (nahezu) be- 
liebig viele verschiedene Objekte ein und dessel- 
ben Typs aufnehmen. 

Als Grundobjekte treten dabei Edit-Felder, 
Push-Buttons, Radio-Buttons, Auswahl-Boxen 
und Action-Buttons in Erscheinung, die jeweils 
unterschiedlichen Aufgaben zugeordnet sind. Wo 
diese Grundobjekte an ihre Grenze stoßen, kön- 
nen sie leicht erweitert oder gar neue Objekt- 
typen kreiert werden, wobei jedoch gewährleistet 
sein sollte, daß diese Objekte dem »Look and 
feel« des SAA-Standards entsprechen, sich also 
harmonisch in die Reihe der Grundobjekte ein- 
fügen. 

In der Regel ist die Erarbeitung neuer Objekte 
jedoch gar nicht notwendig, denn die Grund- 
objekte decken fast alle Bedürfnisse ab. 


a Run Debug Utility 
\MSJ35 SAA5S\UNTITLED.C 


a Options 


GLOBAL FLAGS 
Memory Model 


DEBUG FLAGS 


Debug Info 
reg Info 
Line Numbers Only 


Warn Level 
( ) Level 0 
(*) Level 1 
( ) Level 2 
( ) Level 3 


Pointer Check 
Incremental Compile 


RELEASE FLAGS 


C Language 
NSI Compatibility 
S Extensions 


am] Stack Check 


Optimizations 
[Oo mer or) run] 


] 


< 0K > <Cancel> < Help > 


Edit-Felder 


So kann das Edit-Objekt beispielsweise für jede 
Art alphanumerischer Eingaben herangezogen 
werden. Diese Eingaben werden von Edit in C- 
Strings abgelegt und können dadurch leicht mit 
Hilfe der Standard-Funktionen aus der Laufzeit- 
bibliothek des C-Compilers weiterverarbeitet 
werden. 

Edit-Objekte erkennt man an den eckigen 
Klammern ('[' und ']'), denen in der Regel ein 
Text vorangeht und die das eigentliche Eingabe- 
feld einschließen. Ist ein Edit-Objekt aktiv, wer- 
den diese Klammern und das dazwischen befind- 
liche Eingabefeld farblich hervorgehoben. Der 
blinkende Cursor markiert die Position, an der 
das nächste eingegebene Zeichen in das Eingabe- 
feld aufgenommen wird. 

Das Erscheinungsbild des Cursors markiert den 
Eingabemodus. Der normale Cursor, der die 
untersten beiden Zeilen des unter ihm befind- 
lichen Zeichens überdeckt, zeigt den Über- 
schreib-Modus an, in dem die eingegebenen Zei- 
chen die zuvor eingegebenen Zeichen über- 
schreiben. Im Einfüge-Modus, indem das einge- 
gebene Zeichen an der aktuellen Cursorposition 
in das Eingabefeld eingeschoben und die nach- 
folgenden Zeichen nach hinten verschoben wer- 
den, überdeckt der Cursor das gesamte unter ihm 
befindliche Zeichen. Er erscheint dann als Block- 
Cursor. 

Eingefügt werden kann übrigens nur, solange 
sich an der letzten Position im Eingabefeld ein 
Leerzeichen befindet, damit keine Zeichen durch 
das Einfügen aus dem Eingabefeld herausge- 
schoben werden. Bei der Editierung des Eingabe- 
feldes helfen die gewohnten Editier-Tasten wie 
Backspace, Delete, Cursor links, Cursor rechts, 
Home, End und Ctrl-Home. 

Das Eingabefeld muß dabei nicht ganz auf 
dem Bildschirm sichtbar sein. Vielmehr ist es bei 
langen Eingabefeldern sogar üblich, nur jeweils 
einen kleinen Teil des Eingabefeldes innerhalb 
der Dialogbox darzustellen, um Platz zu sparen. 


Bild 1: 

Die Dialogbox zur 
Einstellung von 
Compiler-Optionen 
unter Quick C 2,0 ist 
eine typische SAA- 
Dialogbox mit Push-, 
Radio- und Action- 
Buttons sowie einem 
Edit-Feld. 
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»> Listing 1: 
DLG.H 
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Mit den Cursor-Tasten kann der Anwender 
dann den Teil des Eingabefeldes in den Sicht- 
bereich holen, den er bearbeiten möchte. Auf 
weitere Spezifikationen des Edit-Objekts wird bei 
der Beschreibung des Moduls DLGEDIT.C, das 
dieses Objekt realisiert, später eingegangen. 


Push-Buttons 


Push-Buttons werden überall da eingesetzt, wo 
die benötigte Information als Ja/Nein-Frage for- 
muliert werden kann. Wenn eine Applikation 
vom Anwender wissen möchte, ob die Anschrift 
eines Kunden noch stimmt oder ein Duplikat der 
Rechnung ausgedruckt werden soll, dann emp- 
fehlen sich Push-Buttons, da sie nur zwei Zu- 
stände kennen. 

Der eigentliche Push-Button wird als ein Zei- 
chen zwischen zwei eckigen Klammern darge- 
stellt, das im Aus-Zustand transparent ist und 
durch ein Leerzeichen dargestellt wird, während 
im An-Zustand ein großes X zwischen den ecki- 
gen Klammern erscheint. Rechts von diesen 
Klammern findet sich in der Regel ein Text, der 
in wenigen Worten die Ja/Nein-Frage formuliert, 
um deren Beantwortung gebeten wird. 

Ist ein Push-Button als aktives Objekt markiert 
worden, kann die Umschaltung zwischen den 
beiden Zuständen mit Hilfe der Leertaste erfol- 
gen. Alternativ dazu genügt es auch, den Push- 
Button mit der Maus anzuklicken. 


Radio-Buttons 


Anders als ein Push-Button, der immer für sich 
allein steht, bestehen Radio-Buttons grundsätz- 
lich aus einer Gruppe von Buttons (Knöpfen) von 
denen jeweils nur einer ausgewählt sein kann. 
Ihren Namen verdanken sie den Schaltern an 
einem Radio, die die Auswahl eines Frequenz- 
Bandes erlauben. Hier — und dies ist charakte- 
ristisch für Radio-Buttons — ist die Auswahl von 
Lang-, oder Kurz-, oder Mittelwelle möglich, es 
kann aber immer nur genau eine Einstellung aus- 
gewählt werden. Wird ein Knopf niedergedrückt, 
so springt gleichzeitig der bisher niedergedrückte 
Knopf wieder heraus. 

Um eine optische Unterscheidung zwischen 
Radio- und Push-Buttons zu gewährleisten, wer- 
den Push-Buttons nicht von eckigen, sondern von 
runden Klammern umgeben. Ist ein Push-Button 
niedergedrückt, wird zwischen diesen Klammern 
das Zeichen »*« angezeigt. Ansonsten ist der 
Platz zwischen den beiden Klammern leer. 

Zusammengehörende Push-Buttons werden 
grundsätzlich untereinander aufgeführt, wobei 
jedem Button ein Text folgt, der die jeweilige 
Einstellung nennt. Zwar handelt es sich bei Push- 
Buttons, die aus mehreren Knöpfen bestehen, um 
ein Objekt, doch kann zwischen den einzelnen 
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#inciude *vio.h” /* diese beiden SAA-Include-Dateien aufnehmen */ 


#include "kba.h” 


I*— Makros *} 


#define F(farbe) ( digcol.farbe ) /* liefert Farbe aus der DLGCOL-Struktur */ 


/*— die folgenden Makros helfen bei der Anlage von DLGDATEN-Strukturen für ” 
/*— die einzelnen Objekte Innerhalb einer Dialogbox 


#define EDIT p ) { &p, Bstd_edit_fkt ) 
#define ACTBUT( p ) | &p, Bstd.ab_ fit |} 


PP Konstanten —  — — 7 
/* Zeichen, das einen Hotkey markiert */ 


/* keine Taste */ 
/* keine 'Mal'-Funktion */ 


tdefine HOTKEY „8 
#define NOKEY AKTASTE) 0) 
#define NOPAINTFKT ((PAINTFKT) 0) 


/*— Rückgabecodes für die TASTFKT "/ 


#define TF_MAUS 250 /* aktiviere mich aufgrund eines Naus-Ereignisses */ 
#define TF_AKTIV 251 /* aktiviere mich aufgrund einer Taste PR 
#define TF_WEITER 252 /* Taste/Mausereignis wurde nicht verarbeitet */ 
sdefine TF_ACCEPTED 253 /* Taste/Mausereignis wurde verarbeitet ” 
#define IF_FELD_ VOR 254 /* ein Feld weiterschalten * 
#define TF_FELD_RUECK 255 /* ein Feld zurück “ 

/* alle weiteren Codes werden als Terminations- */ 

/* codes aufgefaßt bj 


I— Typdeklarationen nt / 
typedef BYTE BOOL; 


typedef struct /” Farben, die innerhalb einer Dialogbox Verwendung finden */ 


BYTE digbox, /* Füll-Farbe für gesamte Dialogbox und Rahmen */ 
mm, /* normale Farbe */ 
hi, /" hervorgehobene Farbe */ 
he, /* Farbe für den Hotkey */ 
da, /* Farbe für inaktive Felder (disabled) */ 
dk; /* Farbe für den Hotkey in Inaktiven Feldern */ 

} DLECOL 


extern DLECOL digcol; /* Variable mit Farben für Dialog-Boxen */ 


/*— Deklaration der Funktionen, die jedes Dialog-Feld bereitstellen ud —— 
} I 
STARTFKT : Wird beim Aufbau der Maske aufgerufen. Liefert dem Aufru- | 
I fer einen Zeiger zurück, der bei allen kommenden Aufrufen | 
der verschiedenen Dialogfunktionen übergeben wird. | 
| 
Jeder der folgenden Funktionen wird bei ihrem Aufruf der Zeiger über- 
geben, den die STARTFKT zurückgeliefert hat und an der die Funktion 
feststellen kann, welches der möglicherweise mehreren Dialog-Felder 
dieses Typs angesprochen wird. 
AKTIVFKT : Aktiviert ein Dialog-Feld, nachdem es zuvor über die 
Funktion CANAKTFKT seine Bereitschaft erklärt hat, 
aktiviert zu werden. Teilt dem Dialog-Feld anhand eines 
der TF_...-Konstanten mit, warum es aktiviert wurde. | 
| 
| 
| 
| 


TASIFKT : Der Aufruf erfolgt sowohl während das Dialog-Feld aktiv 
I ist, manchmal aber auch, wenn ein anderes Dialog-Feld 
aktiv ist, dieses die Taste aber abgelegt hat. In diesem 
Fall muß das Dialog-Feld feststellen, ob es die Taste 
verarbeiten kann — ggf. sogar aktiviert wird. 


MAUSFKT : Wie TASTFKT wird diese Funktion sowohl aufgerufen, wäh- 
rend ein Dialogfeld aktiv ist, als auch, wenn es nicht 
aktiv ist, um festzustellen, ob es durch ein Mausereig- 
nis aktiviert werden muß. 


CANAKTFKT : Teilt dem Aufrufer mit, ob das Dislog-Feld bereits ist, 
aktiviert zu werden. 


I 

| 

I NEWVALFKT : Wird nicht vom Scheduler, sondern von einer Verbindungs- 
I prozedur des Anwenders/Programmierers aufgerufen, um dem 
I Dialog-Feld mitzuteilen, daß sich sein Inhalt durch ein 
| äußeres Ereignis verändert hat. In den Standardversionen | 
| der verschiedenen Dialogtypen sind diese Funktionen 

| Dummys. 


DEAKFKT : Teilt dem Dialog-Feld mit, daß es daktiviert wurde. 


ENDFKT : Wird nach der Beendigung der Eingabe innerhalb der Dia- 
logbox aufgerufen, damit das Dialog-Feld einen Reset auf 
seine Daten durchführen kann, Vom Bildschirm muß es sich 
nicht entfernen. 


“/ 


typedef void * (*STARTFKT) ( void * iptr ); 

typedef void (*NEWVALFKT)( void * iptr, void * dptr ); 

typedef void (*ENDEFKT) ( void * iptr ); 

typedef void (*DEAKFKT) ( void * iptr ); 

typedef void (*AKTIVFKT) ( void * iptr, BYTE why ); 

typedef BYTE (*TASTFKT) ( void * iptr, TASTE key ); 

typedef BYTE (*MAUSFKT) ( void * iptr, BYTE x, BYTE y, BYTE ev ); 
typedef BOOL  (*CANAKTFKT)L void ” iptr ); 

typedef struct /" Struktur mit den verschiedenen Funktions-Pointern */ 
[ 

STARTFKT start; 

NEWVALFKT newval; 

ENDEFKT ende; 

TASIFKT taste; 

DEAKFKT deak; 

MAUSFKT maus; 

AKTIVFKT aktiv; 

CANAKTFKT can; 

} DLEFKT; 


typedef DLGFKT *DLGFKTPTR; /* Zeiger auf eine Dialog-Funktions-Struktur */ 
/’— Markos, die bei der Definition von Eingabemengen für EDIT-Felder helfen*/ 


#define SMlm, x, y) 
#define Mm, x, y) 


EdSetMenge(m, x, y, TRUE ) 
EdSetMenge(m, x, y. FALSE) 


#define ClearMenge(m) Mm, 0, 255) 
#define SetMengeAl | (m) SH( m, 0, 255 ) 
#define SetMengelnt{m) SM m, '0', "9" ), SMlm, '+, '-")) 


#define SetHengeAN (m) 
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/*— Beschreibung der Struktur eines Dialogbox-Beschreibers ——t / 


#define SetMengePath(m) 


extern DLGFKT std edit_fkt; 


/* Funktionen zur Verwaltung von Edit- ”/ 
extern DLGFKT std"ab_fkt; “ 


/* Feldern und Action Buttons 
typedef void ("PAINTFKT)( void ); /* Fet. zur Gestaltung einer Dialogbox */ 


typedef struct /* Daten, die für jedes Dialog-Feld benötigt werden */ 
[ 


void * daten; /* Zeiger auf Datenblock */ 
DLGFKTPTR fkts; /* Zeiger auf Struktur mit Dialog-Funktionen */ 
} DLGDATEN; 


typedef DLGDATEN * DLGDPTR; /* Zeiger auf Dialog-Daten */ 


bg struct /* beschreibt eine Dialogbox */ 

BYTE x_ start, /* Koordinaten obere linke Ecke % 
y_start, /* der Dialogbox 

x_len, /* Größe der Dialogbox In 7 

y_\en, /* Spalten und Zeilen # 

anz; /* Anzahl der Dialogfelder */ 


PAINTFKT paintfkt; 
DLGEDPTR datptr; 


/* Funktion zur Gestaltung der Dialogbox */ 
/* Zeiger auf Vektor mit Zeigern */ 
/* auf Dialogfeld-Daten “/ 

} DIGDES; 

typedef DIGDES * DIGDESPTR; /* Zeiger auf Dialogbox-Struktur */ 

/*— Beschreibung der Strukturen, die für ein alphanumerisches Eingabefeld —*/ 

/"— vom Type EDIT benötigt werden | 


typedef BYTE EMENGE[ 64 ]; 
typedef BYTE *EMP; 


/* Eingabemenge */ 
/* Zeiger auf eine Eingabemenge */ 


bes struct /* beschreibt ein alphanumerisches Eingabefeld */ 
BOOL enabled; /* darf das Feld angewählt werden? */ 
BE x /* Anfangskoordinate relativ zur oberen */ 
Y% /* linken Ecke des Dialogbox */ 
len, /* Anzahl der Zeichen im Eingabefeld */ 
vist; /* Anzahl der sichtbaren Zeichen */ 
char * text; /* Text vor dem Eingabefeld */ 
BITE * eingabe; /” Zeiger auf den Eingabepuffer */ 
EMP mptr; /* Zeiger auf die Menge erlaubter Zeichen */ 

) EDITFELD; 


= Beschreibung der Strukturen, die für die Verwaltung von Action Buttons “4 
— (AB) benötigt werden. 

Mn ACHTUNG! Action Buttons darf es im Gegensatz zu EDIT-Feldern, Push- -/ 

/*— Buttons etc. nur einmal pro Dialogbox geben ”/ 


typedef struct /* beschreibt einen Action-Button */ 
t 


BOOL enabled; /* darf der AB ausgewählt werden? */ 
BE x, /* Sildschirmposition relativ zur oberen */ 

Y /* linken Ecke des Dialogfensters “ 
char * name /* Pointer auf String mit Text */ 


TASTE key /* Taste, mit der dieser AP (zusätzlich zum evtl. */ 
/* vorhandenen Hotkey) verbunden wird “/ 
} ONEAB; 

typedef ONEAB *ABPTR; /" Zeiger auf einen AB-Beschreiber */ 
anal struct /* beschreibt eine Gruppe von Action-Buttons */ 
BITE anz, I* Anzahl der Action-Buttons */ 
standard; /* Default Action-Button ”/ 
ABPTR abp; /* Zeiger auf Vektor mi AB-Beschreibern */ 

} ABGROUP; 
Ir— öffentliche Funktionen ——————— 1 / 


BYTE DigStart ( DIGDESPIR dptr ); 
TASTE DigPrint ( BYTE x. BYTE y, char * str, BYTE fn, BYTE fh ); 
void DigDelay ( int pausien ); 
void DigBox { BYTE x, BYTE y, BYTE xien, BYTE ylen, 
BYTE typ, char * titel, BOOL aktiv ); 
void EdSetMenge( EMP mptr, BYTE von, BYTE bis, B00L set ); 
4*— Funktionsdeklarationen über Makrss ————— 1 / 


#define MausPause() Digdelay( 1) /" Pause bei Mausereignissen */ 


Push-Buttons mit Tab und Shift-Tab hin- und 
hergesprungen werden, so als ob es sich um 
unterschiedliche Objekte handelte. Die Auswahl 
eines von mehreren Radio-Buttons erfolgt analog 
zu den Push-Buttons mit Hilfe der Leertaste oder 
durch Anklicken mit der Maus. 


Auswahl-Boxen 


Überall da, wo zwar auch nur eine aus mehreren 
Möglichkeiten ausgewählt werden kann, diese 


Möglichkeiten zum Zeitpunkt der Kompilation 
aber noch nicht feststehen oder groß an der Zahl 
sind, werden Auswahl-Boxen eingesetzt. Umge- 
ben von einem Rahmen und am rechten oder un- 
teren Rand mit einem sogenannten Slider ver- 
sehen, enthält eine Auswahl-Box eine unter- 
schiedliche Anzahl gleich breiter Auswahlen, von 
denen immer nur so viele gleichzeitig zu sehen 
sind, wie in die Auswahl-Box am Bildschirm pas- 
sen. 

In der Art einer Tabellenkalkulation können 
weitere Einträge mit Hilfe der Cursor-Tasten in 
die Auswahl-Box geholt werden, doch werden 
dafür andere Einträge aus dem Sichtbereich her- 
ausgescrollt. Man muß sich diese Organisation 
der Einträge als eine Art Matrix vorstellen, von 
der immer nur ein bestimmter Teil im Sicht- 
bereich der Auswahl-Box angezeigt wird. 

In welcher Scroll-Richtung darüber hinaus 
noch weitere Einträge existieren, zeigt jeweils ein 
Slider an, der auch zur Fortbewegung zwischen 
den einzelnen Einträgen mit Hilfe der Maus 
dient. Dem Programmierer steht es bei der De- 
klaration einer Auswahl-Box frei, die Breite der 
einzelnen Einträge sowie die Anzahl der unter- 
einander oder nebeneinander angezeigten Ein- 
träge zu wählen. 

Die in Bild 2 dargestellte Dateiauswahlbox 
beinhaltet gleich zwei dieser Auswahl-Boxen. 
Eine, um ein Laufwerk bzw. Verzeichnis auszu- 
wählen und eine andere, um eine der darin be- 
findlichen Dateien zu markieren. 


Action-Buttons 


Den letzten Grundtyp unter den verschiedenen 
Dialog-Objekten stellen die Action-Buttons dar, 
die sich von den bisher beschriebenen Objekt- 
Typen insofern unterscheiden, als das jedes Dia- 
logfeld über genau ein Objekt vom Typ Action- 
Button verfügen muß. 

Daß dem so ist, hängt mit dem besonderen 
Charakter der Action-Buttons zusammen, denn 
nur mit ihrer Hilfe kann die Eingabe in der Dia- 
logbox beendet werden. 

Dabei kann ein Action-Button aus einer belie- 
bigen Anzahl verschiedener Knöpfe bestehen, die 
jeweils mit einer bestimmten Aktion verbunden 
werden. Zumindest drei dieser Knöpfe findet 
man denn auch in fast jeder Dialogbox: 

° einer mit dem Namen »OK«, der zum 
Schließen der Dialogbox führt und die einge- 
gebenen Daten übernimmt, 

® einer, der den Titel »Abbruch« trägt und eben- 
falls zum Schließen der Dialogbox führt, aller- 
dings ohne daß die Daten übernommen werden, 
und schließlich 

* einer, mit dem Namen »Hilfe«, der Hilfsinfor- 
mationen über die Dialogbox auf den Bildschirm 
holt und nach deren Betrachtung wieder in die 
Dialogbox zurückkehrt. 


44 Listing 1: 
Ende 


SAAinC 


Microsoft 
System Journal 
Sept./Okt. 1989 


119 


ogFie RT 


Make Run Debug 


File Name: [*.c 


File List: 


DLG.C 
DLGAB.C 
DLGDEMO.C 


DLGEDIT.C 


Bild 2: 

Die Dateiauswahlbox 
von Quick C enthält 
gleich zwei Auswahl- 
Boxen und ein Edit- 
Feld. 


SAAinC 


Microsoft 
System Journal 
Sept./Okt. 1989 


120 


C:\MSJ35\ SAAS 


Window: Source 


Drives / Dirs: 


Erkennen können Sie Action-Buttons an den 
Zeichen »<« und »>«, zwischen denen der Name 
des Buttons aufgeführt wird. Plaziert werden sie 
in der Regel in der untersten Zeile der Dialogbox 
— von den anderen Objekten durch eine horizon- 
tale Linie getrennt. 

Jeder der verschiedenen Buttons kann mit 
einer. bestimmten Taste verbunden werden, so 
daß beispielsweise die Betätigung der Esc-Taste 
der Auswahl des »Abbruch«-Buttons gleich- 
kommt. 

Auch gibt es einen Standard-Button, der im- 
mer dann aktiv ist, wenn sich der Anwender 
nicht innerhalb der Gruppe der Action-Buttons 
befindet, also nicht im Begriff ist, einen bestimm- 
ten Button auszuwählen. Sofern kein anderer 
Button mit der Return-Taste verbunden ist, wird 
bei der Betätigung dieser Taste der Standard- 
Button ausgelöst. 


Interdependenzen in 
Dialogboxen 


Dialogboxen, wie wir sie in Bild 1 sehen, sind 
sehr einfach zu verwirklichen, da hier keine 
Interdependenzen, keine Abhängigkeiten, zwi- 
schen den einzelnen Feldern bestehen. Jedes 
nimmt eine Information auf, die völlig isoliert 
von den Eingaben in andere Felder betrachtet 
werden kann. 

Oft ist es jedoch gerade nicht so. Oft gibt es 
Abhängigkeiten zwischen den verschiedenen 
Objekten, wie z.B. innerhalb der Dateiauswahl- 
box in Bild 2. Wählt der Anwender eine Datei- 
kennung im Edit-Feld aus, muß die Dateibox neu 
aufgearbeitet werden, um alle Dateien aufzufüh- 
ren, die auf diese Dateikennung passen. Dieser 
Vorgang muß wiederholt werden, sobald in der 
Auswahl-Box, die der Auswahl des Laufwerks 
gewidmet ist, ein neues Laufwerk ausgewählt 
wird. Andersherum muß der Dateiname im Edit- 
Feld verändert werden, sobald der Anwender 
innerhalb der Dateibox einen neuen Dateinamen 
anwählt. 


Da die Objekte innerhalb einer Dialogbox auf 
fast beliebige Art und Weise miteinander ver- 
knüpft und diese Verknüpfungen zum Teil auf- 
wendige Operationen (etwa die Suche nach pas- 
senden Dateinamen in einem Verzeichnis) bein- 
halten können, ist es dem Dialog-Manager natür- 
lich unmöglich, diese Verknüpfungsoperationen 
als Teil seiner Aufgaben wahrzunehmen. 

Da auf diese Verknüpfungen aber auch nicht 
verzichtet werden kann, stellt sich an den Dialog- 
Manager (auch Scheduler genannt) die Forde- 
rung, daß Funktionen des Programmierers 
Zugriffsmöglichkeiten auf den Prozeß der Daten- 
eingabe innerhalb der Dialogbox einzuräumen 
ist. Diese Forderung bestimmt in hohem Maße 
die Struktur des Dialog-Managers, wie sie im fol- 
genden Abschnitt beschrieben wird. 


Die Struktur des 
Dialog-Managers 


Der Dialog-Manager, der zusammen mit seinen 
Hilfsfunktionen in der Datei DLG.C unterge- 
bracht ist, trägt den Namen DlgStart(). Er agiert 
unabhängig von der Art der Objekte innerhalb 
der Dialogbox, denn ihm gegenüber treten die 
einzelnen Objekte nur in Form von acht soge- 
nannten Dialog-Funktionen auf, die jedes Objekt 
unterstützten, besser gesagt, beinhalten muß. 
Diese Funktionen bzw. Zeiger, die auf sie verwei- 
sen, werden innerhalb der Include-Datei DLG.H 
definiert, die jede Applikation einbinden muß, 
die sich der Dienste des Dialog-Managers bedie- 
nen möchte. 

DigStart() muß bei seinem Aufruf ein Zeiger 
auf eine Struktur vom Typ DIGDES übergeben 
werden, die alle Informationen enthält, die der 
Dialog-Manager zur Verwaltung der Dialogbox 
benötigt. 

Dies ist zunächst einmal die Koordinate der 
oberen linken Ecke der Dialogbox sowie die 
Größe in Zeilen und Spalten. Mit Hilfe dieser 
Information öffnet der Dialog-Manager ein Bild- 
schirmfenster, löscht seinen Inhalt und zieht 
einen einfachen Rahmen darum. 

Des weiteren findet sich in dieser Struktur die 
Anzahl der Objekte und ein Zeiger mit dem 
Namen paintfkt, der auf eine Funktion des Auf- 
rufers verweisen kann, die während des Aufbaus 
der Dialogbox vom Dialog-Manager aufgerufen 
wird. Dadurch soll dem Aufrufer die Möglichkeit 
geboten werden, in die Gestaltung der Dialogbox 
einzugreifen, etwa, um eine waagerechte Linie 
zwischen den Action-Buttons und den anderen 
Objekten zu ziehen oder einen Text in die Dia- 
logbox zu schreiben. Möchte der Aufrufer von 
dieser Möglichkeit keinen Gebrauch machen, 
kann er an der entsprechenden Stelle innerhalb 
der Struktur an Stelle eines Funktionsnamens die 
Konstante NOPAINTFKT einsetzen. 


[enannnsnnkkennatnnarnnnsnn nennen nennen / 


oe dbi6s.c “7 
/I* / 
/" Aufgabe : Stellt im Rahmen der SAA-Serie eine Funktion zur ” 
BR Erstellung und Verwaltung beliebiger Dialogboxen zur */ 
!* Verfügung. “ 
rs “/ 
p Autor t MICHAEL TISCHER u 
/* entwickelt am : 13.07.1989 “/ 
„r letztes Update : 17.07.1989 I 
|P—— 22222 
/* Erstellung x CL /ALSIMJCILIH] DLE.C [ DLGEDIT.C, DLGAB.C ...] /C 
I» dann mit einem anderen Modul linken 5, 


[eermnennnnnnnenntnnnsenntennnne nennen nennen nn nen annnnnnee/ 


/*— Include-Dsteien einbinden “/ 
#include <string.h> 

#include menory.h> 

#inchude malloc.h> 

#include «dos.h> 

#inciude "dig.h” 


/*— globale Variablen “/ 
DLGCOL digcol = [ 0x70, 0x70, 0x07, 0x01, 0x70, 0x70 |; /" Dialog-Farben */ 
BOOL ende, /* zeigt das Ende der Eingabe an "/ 
maus; /* ist TRUE, wenn die Mausaktiwität verfolgt wird */ 

BYTE aktiv, /* Nummer des aktiven Dialog-Feldes */ 
retcode; /* Return-Wert für Aufrufer */ 

void ** idptr, /* Zeiger auf Vektor mit Id-Zeigern der Felder */ 
* aktip; /* Zeiger auf Element des aktiven Feldes */ 


DLEOPTR aktdigp; 
DIEDES dp: 


/* Zeiger auf Infos über aktuelles Dialog-Feld */ 
/* Daten der Dialogstruktur */ 


#define FKT(x) (*(aktdigp->fkts>x)) 
ddefine FKTLIx) (*(digdptr-fkts>x)) 


/* Dig-Fkt. des akt. Feldes aufr. */ 


[eeeummennnennnnnnntnenennte nennen anne een 


* Funktion :DIgiProcessKey a 
A  —— 
* Aufgabe * Interne Funktion des DL6-Moduls, bearbeitet eine ein- * 
? gegebene Taste. he 
* Eingabe-Parameter: KEY = Code der betätigten Taste N 
* Return-Wert : keiner s 
* Globals : ENDE, RETCODE, AKTIV, AKTIP, AKTDLGP a 
aransenunnnnnnnnnnnnnnen nun nn nn ana hnn nennen n trennen / 


BYTE Digiprocesskey( TASTE key ) 


BYTE neuaktiv; 
void ** Nidptr; 
DLEDPTR digdptr; 


/* Nummer des neuen aktiven Feldes */ 
/* Laufzeiger in IDPTR-Vektor */ 
/* Laufzeiger in Vektor auf den dp.datptr zeigt */ 


switch ( retcode = FKT(taste)( aktip, key ) ) /* Taste an akt. Feld senden */ 


/* nachfolgendes Dialog-Feld aktivieren */ 
neuaktiv = aktiv; /* Suche im nächsten */ 
lidptr = idptr + neuaktiv; 7" Dialog-Feld be- */ 
digdptr = aktdigp; /" ginnen ®, 
do /* Suchschleife */ 


case TF_FELD_VOR 


{ 
if ( +mewaktiv == dp.anz ) /* zum ersten Feld springen? */ 
I Ja */ 
/* bei Feld #0 fortfahren */ 
/* Zeiger auf das jeweils erste */ 
/* Element im Vektor setzen “/ 


nevaktiv = 0; 
Vidptr = Idptr; 
digdptr = dp.datptr; 


else /* Nein, es folgt noch ein Feld */ 
+lidptr; /* die beiden Zeiger auf das nächste '*/ 
+dlgdptr; /* Element im jeweiligen Vektor setzen */ 
1 
while ( I ( newaktiv == aktiv || FKTLican)( *lidptr ) ) ); 
if ( newaktiv I» aktiv ) /* wurde ein anderes Feld aktiviert? ”/ 
Ir Ja* 


FKT(deak)( aktip ); /* aktuelles Feld deaktivieren */ 
aktip = "lidptr; /" Ptr auf Datenblock des aktiven Feldes merken */ 
aktdigp = digdptr; /* Ptr auf Daten mit Infos über akt, Feld merken */ 
aktiv = neuaktiv; /* Nummer des Feldes merken */ 
ERTIORENSIN aktip, TF_FELD_VOR ); /* neues Feld aktivieren */ 
break; 
case TF_FELD RUECK : /* vorhergehendes Dialog-Feld aktivieren */ 
neuaktiv = aktiv; /* Suche im vorher- */ 
Iidptr = fdptr + neuaktiv; /* gehenden Dialog- */ 
digdptr = aktdigp; /* Feld beginnen “/ 
do #* Suchschleife */ 


/" zum letzten Feld springen? */ 
Ir Ja» 

/* bei Feld #anz-i fortfahren */ 
/* Zeiger auf das jeweils letzte */ 


{ 
if ( neuaktiv— == 0) 


neuaktiv = dp.anz-1; 
lidptr = Idptr + neuaktiv; 


digdptr = dp.datptr + neuaktiv; /* Element im Vektor setzen 7 
else /* Nein, es geht noch ein Feld voraus */ 

{ 
—Hidptr; /" die beiden Zeiger auf das vorhergehende */ 
—dlgdptr; /* Element im jeweiligen Vektor setzen Y 

! 

while ( 1 ( neuaktiv == aktiv || FKTL(can)( *lidptr ) ) ); 

‚H ( neuaktiv I” aktiv ) /* wurde ein anderes Feld aktiviert? */ 
Ir Jar 


FKT(deak)( aktip ): /* aktuelles Feld deaktivieren */ 
aktip = *lidptr; /* Ptr auf Datenblock des aktiven Feldes merken "/ 
aktdigp = digdptr; /* Ptr auf Daten mit Infos über akt. Feld merken */ 
aktiv = neuaktiw; /* Nummer des Feldes merken */ 
FKT(aktiv)( aktip, TF_FELD RUECK ); /* neues Feld aktivieren */ 
} 
break; 
case TF_ WEITER /* Feld suchen, das diese Taste verarbeitet */ 
neuaktiv = aktiv; /* Suche im nächsten */ 
Midptr = idptr + neuaktiv; /* Dialog-Feld be- */ 
digdptr = aktdigp; /" ginnen ° 
do /* Suchschleife */ 
if ( +neuaktiv == dp.anz ) /" zum ersten Feld springen? */ 
ie da 


newaktiv = 0; /* bei Feld #0 fortfahren */ 
Yidptr = idptr; /* Zeiger auf das jeweils erste */ 
digdptr = dp.datptr; /* Element im Vektor setzen u} 
else /* Nein, es folgt noch ein Feld */ 
++lidptr; /* die beiden Zeiger auf das nächste */ 


+digdptr; /* Element im jeweiligen Vektor setzen */ 
l 


} 


Als letzten Eintrag enthält eine DIGDES-Struk- 
tur einen Zeiger auf einen Vektor, mit einem Ein- 
trag für jedes der Objekte innerhalb der Dialog- 
box. Solch ein Vektor setzt sich aus Elementen 
vom Typ DLGDATEN zusammen. Dieser Typ 
stellt wiederum eine Struktur dar, die zwei Zei- 
ger enthält. Der erste ist ein void-Zeiger, der auf 
eine beliebige Struktur verweisen kann, die 
Daten über das jeweilige Objekt enthält. Dem 
Dialog-Manager ist die Struktur dieser Daten 
unbekannt, doch ist sie für ihn auch gar nicht 
von Interesse, da er sie selbst nicht verarbeiten 
muß, sondern diesen Zeiger lediglich an die Dia- 
log-Funktionen weitergibt, die mit ihm ganz 
nach Belieben verfahren können. 

Der zweite Zeiger hingegen ist typisiert — er 
zeigt auf eine Struktur vom Typ DLGFKT, die 
Zeiger auf die acht Dialog-Funktionen eines Ob- 
jekts beinhaltet. Daß die einzelnen Funktionszei- 
ger hier nicht direkt aufgeführt, sondern durch 
einen Zeiger auf eine DLGFKT-Struktur referen- 
ziert werden, hat einen ganz besonderen Grund. 
So lange Sie nämlich keine Abhängigkeiten zwi- 
schen den einzelnen Objekten definieren müssen 
und daher mit den Standard-Objekten arbeiten 
können, werden auch immer die Standard-Dia- 
log-Funktionen des jeweiligen Objekts aufgeru- 
fen. Es ist deshalb einfacher, einmal eine Struk- 
tur mit den Zeigern auf diese Funktionen als glo- 
bale Variable zu definieren und sie innerhalb der 
DLGDATEN-Struktur zu referenzieren, als die 
einzelnen Funktionszeiger in jeder dieser Struk- 
turen separat aufzuführen und so nicht nur Spei- 
cherplatz, sondern auch wertvolle Zeit beim Ein- 
tippen zu vergeuden. 

Darüber hinaus stellt jedes Objekt ein Makro 
zur Verfügung, mit dessen Hilfe Sie eine DLG- 
DATEN-Struktur für Objekte dieses Typs erstellen 
können, ohne mit dem Zeiger auf die DLGFKT- 
Struktur in Berührung zu kommen. Das’folgende 
Beispiel zeigt dieses Makro für EDIT-Felder. 


#define EOIT( p ) { äp, Astd_edit_fkt ) } 


Hier wird neben dem Zeiger auf die Daten also 
auch direkt einer auf die Struktur std_edit_fkt 
referenziert, die vom Modul DLGEDIT.C bereit- 
gestellt wird und Zeiger auf die Standard-Dialog- 
Funktionen für ein Edit-Objekt enthält. Die Rei- 
henfolge, in der die einzelnen Objekte innerhalb 
des Vektors mit den DLGDATEN-Strukturen auf- 
geführt werden, bestimmt auch die Reihenfolge, 
in der die einzelnen Felder mit Hilfe von Tab und 
Shift-Tab angesprungen werden können. 


Dialog-Funktionen zur 
Verbindung zwischen Dialog- 
Manager und einem Objekt 


Die erste der acht Dialog-Funktionen, die START- 
FKT, ruft der Dialog-Manager nur einmal wäh- 
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rend der Initialisierung der Dialogbox, unmittel- 
bar nach dem Öffnen des Dialogfensters, auf. 
Damit sie auf die Daten des zugehörigen Objekts 
zugreifen kann, wird ihr bei ihrem Aufruf auch 
gleich der Zeiger auf die Objekt-Daten aus der 
DLGDATEN-Struktur des Objekts übergeben. 

Als Return-Wert erwartet der Dialog-Manager 
einen Zeiger vom Typ void, den er bei allen künf- 
tigen Aufrufen der anderen Dialog-Funktionen 
übergibt. Um die Bedeutung dieses Zeigers zu 
ermessen, müssen Sie sich in Erinnerung rufen, 
daß jedes Objekt (ausgenommen die Action-But- 
tons) innerhalb einer Dialog-Box mehrmals auf- 
treten kann. Da aber zumindest die Standard- 
Objekte in jeder DLGDATEN-Struktur eines Ob- 
jekts auf den gleichen Satz von Dialog-Funktio- 
nen verweisen, werden ein- und dieselben Funk- 
tionen für mehrere Objekte in unvorhersehbarer 
Reihenfolge aufgerufen. 

Wenn für jedes Objekt eines bestimmten 
Objekttyps (für jede »Instanz« eines Objekts) nun 
interne Informationen, wie etwa die Cursor-Posi- 
tion innerhalb eines Eingabefelds oder der Status 
eines Push-Buttons verwaltet werden müssen, 
dann müssen die einzelnen Dialog-Funktionen 
die verschiedenen Instanzen auseinanderhalten 
können. Deshalb deklarieren die Dialog-Funktio- 
nen von Objekt-Typen, die interne Informationen 
über ihr Objekt verwalten müssen, in der Regel 
eine interne Struktur, in der alle diese Informa- 
tionen Platz finden. Beim Aufruf der STARTFKT 
allokieren sie auf dem Heap Speicherplatz für 
eine solche Struktur, initialisieren sie und liefern 
die Adresse dieser Struktur als Zeiger an die 
STARTFKT zurück. (Neben internen Daten sollte 
auch die Adresse der Objekt-Daten in dieser 
Struktur verzeichnet sein, damit jede Dialog- 
Funktion neben den internen Daten auch auf die 
Objekt-Daten zugreifen kann.) 

Indem der Dialog-Manager allen anderen 
Dialog-Funktionen diesen Zeiger übergibt und 
die Dialog-Funktionen auf die Daten innerhalb 
der dadurch referenzierten Struktur zugreifen, 
können mit einem Satz von Dialog-Funktionen 
eine beliebige Anzahl von Instanzen eines Ob- 
jekt-Typs gleichzeitig bearbeitet werden. So weit 
zur STARTFKT. 

Die CANFKT ruft der Dialog-Manager immer 
dann auf, wenn er nach einem Objekt sucht, das 
bereit ist, als aktives Objekt ausgewählt zu wer- 
den. Ist diese Bereitschaft vorhanden, sollte die 
CANFKT TRUE zurückliefern, anderenfalls 
FALSE. 

Immer, wenn der Dialog-Manager ein Objekt 
aktivieren möchte, also beispielsweise, wenn ein 
vorhergehender Aufruf der CANFKT eines Ob- 
jekts den Wert TRUE zurückgeliefert hat, ruft der 
Dialog-Manager die AKTIVFKT auf. Ihr Aufruf 
teilt dem Objekt mit, daß und warum das Objekt 
aktiviert wurde. Dadurch wird dem Objekt die 
Möglichkeit geboten, sich selbst auf dem Bild- 
schirm hervorzuheben, den Cursor zu plazieren 


while ( neuaktiv Ir aktiv && 
( retcode = FKfL(taste)(*Tidptr, key) ) == TF_WEITER ); 

if ( neuaktiv I" aktiv ) /* wurde die Taste verarbeitet? */ 
Ir 3a” 

/* das Feld SkENIereN? " 
Ir dar 

FKT(deak)( aktip ); /" aktuelles Feld aktiven "/ 

aktip = *lidptr; /* Ptr auf Datenblock des aktiven Feldes merken */ 

aktdigp = dlaspers- /*Ptr auf Daten mit Infos über akt. Feld merken*/ 

aktiv = neuakt /* Nummer des Feldes merken */ 

FKT{aktiv)( Berg 'ır AKTIV ); /* neues Feld aktivieren */ 


{ 
if ( retcode =» TFLAKTIV ) 


else /* Nein, mit zurückgeliefertem Code terminieren */ 
ende = TRUE; /* Return-Flag setzen */ 
) 


break; 
case TF_ACCEPTED /* Taste wurde verarbeitet */ 


break; /* nichts passiert */ 
default /* jeder andere Code bedeutet Termination */ 
Ah Kal ); /" aktuelles Feld deaktivieren */ 
ende = /* Return-Flag setzen */ 
break; 
l 
} 
[erwenannnanenanenennenennenen nennen 
* Funktion :DigStart ” 
* Aufgabe : Stevert die Bearbeitung einer Dialog-Box .! 
* Eingabe-Parameter: DPTR = Zeiger auf eine Dialogstruktur id 
* Return-Wert : Terminations-Code r 


#erkeneneeneennne nennen ee 


BYTE DigStart{ DIGDESPIR dptr ) 
{ 


BYTE i, /* Schleifenzähler */ 
m, /* Position des Mauscursors als Koordinate */ 
my; /* in Bezug auf den gesamten Bildschirm */ 


/* Ereignis von KbmfventWait() */ 
/* Laufzeiger in IDPTR-Vektor */ 


void Nidptr; 
/* Laufzeiger in Vektor auf den dp.datptr zeigt */ 


DLEDPTR digdptr; 


TASTE key; /* empfangene Taste */ 
dp = *dptr; /* Dialogstruktur in globale Variable kopieren */ 
HoukideMouse() ; /* Maus-Cursor ausblenden */ 


VioWinöpen( dp.x_start, dp.y_ start, i* Fenster für Dialogbox Öffnen */ 
dp.x_ start + dp.x_len - 1, dp.y start + dp.y_len - 1); 

VioFrame( VL(0), vo(o), VR(O), VU(O), EINRA, F{digbox) ); 

VioFsTIE VL(2), voll). vRt-1). Wul-1), * *, Fldigbox) ); 


/* gibt es eine Paint-Funktion? */ 


if ( dp.paintfkt i= NOPAINTFKT ) 
/* Ja, diese Funktion aufrufen */ 


(*dp.paintfkt)(); 


/"— Vektor zur Aufnahme der Identifikations-Pointer allokieren und Dia- -*/ 
F*— logfunktion STARTFKT der einzelnen Dialog-Felder aufrufen -. 


Iidptr = idptr = (void **) malloc( sizeof( void * ) * dp.anz ); 
for ( digdptr = dp.datptr, 1 = 0; 1 < dp.anz; ++digdptr, +1 ) 
*lidptr++ = FKiL(start)( (digdptr)->daten ); 


/*— Eingabeschleife, zunächst aktives Dialog-Feld ermitteln ——#t / 
for ( aktiv = 0, lidptr = idptr, digdptr = dp.datptr; 

1 FKTL(can)( *lidptr ); 

+aktiv, ++digdptr, ++lidptr ) 


Woushowleuset) ; 


aktip = *lidptr; /* Zeiger auf Datenblock des aktiven Feldes merken "/ 
aktdigp = digdptr; /* Zeiger auf Daten mit Infos über aktives Feld merken */ 
FKT(aktiv)( aktip, TF_FELD VOR ): /* ausgewähltes Dialog-Feld aktivieren */ 
maus = ende = FALSE; 

do 


/" Maus-Cursor wieder anzeigen */ 


/* muß die Maus überwacht werden? */ 
/* Ja, Ereignis von Maus oder Tastatur erwarten */ 
event = KbmEventWait( EV KEY _AVAIL | EV_MOU_ALL ); 
if ( event & EV KEY AVAIL ) 
DigiProcessKeyl KbdGetKey() ); 


ee 


/* Taste betätigt? */ 
/* Ja, holen und auswerten */ 


else /* Nein, Maus-Ereignis */ 
{ /* Dialog-Feld suchen, das sich der Maus bemächtigt */ 
mx = NoußetCol(); /* Position des Maus-Cursors */ 


my = MoußetRow(); /* holen und merken “ 
retcode = FKT(maus)( aktip, mx, my, event ); /* Mausev. übermitteln */ 
if ( retcode == TF_WEITER ) /* wurde das Event verarbeitet? */ 
/* Nein, Feld suchen, das das Ereignis akzeptiert */ 
for ( i = 0, lidptr = idptr, digdptr = dp.datptr; 
1 < dp.anz; 
++i, Hdlgdptr, ++lidptr ) 
0a [& aktiv 86 
FKTL(maus)( *Vidptr, mx, my, event ) == TF_MAUS ) 
reak; 
X ( i < dp.anz ) /* wurde ein Dialog-Feld rien ih 
I Ja*/ 
FKT(deak)( aktip ); /* aktuelles Feld Katie "/ 
aktip = *lidptr; /* Ptr auf Datenblock des akt. Feldes merken */ 
/* Ptr auf Daten über akt. Feld merken */ 
/* Nummer des Feldes merken */ 
/* neues Feld aktivieren */ 


aktdlgp = digdptr; 
aktiv =; 
FKT(aktiv)( aktip, TF_MAUS ); 
} 


else /* kein Feld nimmt die Maus in Anspruch */ 
maus = FALSE; /* Maus nicht mehr überwachen */ 
) 
else /* kein TF_WEITER emfangen */ 


ende = ( retcode I= TF_ACCEPTED ); /* terminieren? */ 
} 
else 
{ /* Nein, auf Taste oder Betätigung des linken Mausknopfs warten */ 
event = KbmEventhait( EV KEY_AVAIL | EV_LEFT_PRESS ); 
if ( event & EV KEY MAIL ) /* Taste betätigt? */ 
DigiProcesskeyl KbdGetkey() ); /* Ja, holen und auswerten */ 
else /* Nein, linker Mausknopf wurde niedergedrückt */ 
{ {* Dialog-Feld suchen, das sich der Maus bemächtigt */ 
mx = MoußetCol(}; J* Position des Maus-Cursors */ 


my = MoußetRow(); /* holen und merken " 
for ( i = 0, lidptr = idptr, digdptr = dp.datptr; 
1 < dp.anz 


FKTL(maus)( *iidptr, mx, my, EV_LEFT PRESS ) I= TF_MAUS; 

++, +dlgdptr, ++lidptr ) 

if (I < dp.anz ) #* wurde ein Dialog-Feld gefunden */ 
Ir Ja * 

FKT(deak)( aktip ); /* aktuelles Feld deaktivieren */ 
aktip = "lidptr; /" Ptr auf Datenblock des akt. Feldes merken */ 
aktdigp = alawer, /"Ptr auf Daten mit Infos über akt. Feld merken*/ 


aktiv = /* Nummer des Feldes merken */ 
EErtaken)t "aktip, TF_MAUS ); /* neues Feld aktivieren */ 
maus = TRUE; /* Maus jetzt überwachen */ 


while { lende ); /* wiederholen, bis Ende-Flag gesetzt wurde */ 


/*— die einzelnen Dialogfelder durchlaufen und die Dialog-Funktion ”/ 
/®— ENDEFKT aufrufen =) 


MouHideMouse(); /* Maus-Cursor ausblenden */ 
Iidptr = Idptr; /* jeweils den von STARTFKT retournierten Zeiger überg. */ 
for ( digdptr = dp.datptr, I = 0; 

4 < dp.anz; 

++digdptr, ++i ) 
{ *ldlgdptr)->fkts->ende )( *"lidptr++ ); 


VioWinClose( TRUE ); 
Woushowkouse() 
return retcode; 


/* Dialogfenster wieder schließen */ 
/* Maus-Cursor wieder einblenden */ 
/* Return-Code zurückliefern */ 


fpeeemmmmeemeneeeeneenenenne nennen nennen nennen nennen 


* Funktion :DiIgPrint 7 
. 


: Steht allen Arten von Dialog-Feldern zur Verfügung, 
die einen Text innerhalb der Dialog-Box ausgeben 

° möchten. 

. Trifft die Funktion innerhalb des auszugebenden Textes 

- auf das Zeichen HOTKEY, betrachtet es den nachfolgen- 

« den Buchstaben als den Hotkey des Dialog-Feldes und 

« liefert dessen Tastaturcode in Verbindung mit der ALT- 

. Taste zurück 

* Eingabe-Parameter: x, y = Ausgabeposition in Bezug auf den gesamten 

. 

. 

. 

. 

. 

. 

. 


* Aufgabe 
. 


Bildschirm. 
str = Zeiger auf den auszugebenden String. 
fn = Farbe für normale Zeichen. 
fh = Farbe für den Hotkey. 
+ NOKEY, wenn kein Hotkey entdeckt wurde, sonst der Tas- * 
taturcode des Hotkeys. ei 


EEE ee 


nr nee“ 


Return-Wert 


TASTE DigPrint( BYTE x, BYTE y, char * str, BYTE fn, BYTE fh ) 


static TASTE altcodes[] = /* Codes der Alt-Tasten */ 
l 

ALT_A, ALT_B, ALT_C, ALT_D, ALT_E, ALT_F, ALT_G, ALTH, 

ALT“ 1, ALT, I. ALT/| K, ALT_ TL, ALT M, ALT un ALT 70, ALT_ ZB 

ALT Qu ALT“ R, ALT“ 25, ALT“ _T ALT U, ALT/ VAT ar ALT) I 

ALT") Y ALT Er 
h 
TASTE retkey; /* zurückgelieferter Hotkey */ 
retkey = NOKEY; 
while ( *str ) 


/* nicht von Hotkey ausgehen */ 
/* den Ausgabestring durchlaufen */ 


/* Hotkey entdeckt? */ 
Ir Ja * 

/* Hotkey merken */ 

/* Hotkey ausgeben */ 


{ 
if ( "str == HOTKEY ) 
{ 


retkey = altcodes[ tolower( *++str ) - 'a' ]; 
Vioprintf(a+*, y, fh, FALSE, *ıc*, *str++ ); 


! 
else /* kein Hotkey */ 
Vioprintf( x++, y, fn, FALSE, *"sc*, *stre+ ); /* Zeichen ausgeben */ 


return retkey; /* den Hotkey zurückliefern */ 
} 


[eenmnnnnnnsnnnnnntennnennehe nenne 


* Funktion :DigDelay . 
ER .. 
* Aufgabe : Realisiert eine Zeitverzögerung auf der Basis des B10S * e 
hd Timers. 

* Eingabe-Parameter: PAUSLEN = Länge der Pause in Ticks ” 
« (1 Ticks entspricht 1/18,2 sec.) s 
* Return-Wert : keiner 2 


#enntsentnentetenenneennennnhernann nenn anne / 


void DigDelay{ int pauslen ) 

{ 

register unsigned int zeit_hi, /* Zeitzähler */ 
zeit_lo; 

union REGS inregs, 
outregs; 


/* Prozessorregister */ 


/* Funktion 00h = Zeitzähler auslesen */ 
/* Zeit holen und merken */ 


inregs.h.ah » 0; 

int86( Oxta, Ainregs, Soutregs ); 
zeit_hi = outregs.x.ca; 

zeit_lo = outregs.x.dx; 


/* wiederholen, bis pausien auf 0 */ 
/* heruntergezählt wurde 7 
/* Zeit holen */ 


while ( pausien ) 
intd6( Oxla, Ainregs, Aoutregs ); 
I— neuer Tick angebrochen ————————— 0 / 


4f ( zeit_hi I= outregs.x.ca || zeit_lo I= outregs.x.dx ) 
q Ir 3a */ 
zeit_hi = outregs.x.ck; /* neue Werte der Zeitzähler merken */ 
zeit_lo = outregs.x.dx; 
—pauslen; 


! 
} 


/* Anzahl verbleibender Ticks dekrementieren */ 


femeunnnennnnnnnnnsnnnennnsennten nennen een nennen een 


* Funktion :DiIgBox ” 
. 


- 
: Zieht einen Rahmen innerhalb einer Dialogbox und setzt * 
einen Titel hinein. 
* Eingabe-Parameter: X, Y = Start des Rahmens relativ zu oberen linken 
Ecke der Dialogbox 
XLEN, = Breite des Rahmens 
YLEN, = Höhe des Rahmens 
TYP = Rahmentyp (EINRA, DOPRA etc.) 
TITEL = der Titel, der in der ersten Rahmenzeile aus- 


* Aufgabe 
. . 
. 
. 
. 
. 
. 
. 
gegeben wird 2 
. 
. 
. 
. 
. 
/ 


AKTIV = TRUE, Rahmen und Titel werden in den Farben 
aktiver Felder gezeichnet. 

* Return-Wert + keiner 

* Info : Hotkey-Markierungen im Titel werden nicht berücksich- 

r tigt und wie normale Zeichen ausgegeben. 


ELELZEIESTZEST ESTER TEEPIEP DT De EEE 


void Digdox( BYTE x, BYTE y, BYTE xien, BYTE ylen, 
BYTE typ, char * titel, BOOL aktiv ) 


l 
BYTE f; /* Ausgabefarbe */ 
Vioframe( VL(x),. Voly). ll. Nolyeylen-1), 


typ, f = aktiv ? F(hi) : Flnm) ); 
VioPrint( VL( xs(xlen-strien(titel) >> 1) ), Vol y ). f, FALSE, titel ); 
} 


und gewisse Initialisierungen vorzunehmen, die 
für die weitere Dateneingabe innerhalb des Ob- 
jekts von Bedeutung sind. 

Genau wie der Dialog-Manager ein Objekt von 
seiner Aktivierung durch den Aufruf der AKTIV- 
FKT in Kenntnis setzt, genau so ruft er auch die 
DEAKFKT auf, um einem Objekt mitzuteilen, daß 
es deaktiviert wurde. Für das Objekt verbindet 
sich mit dem Aufruf dieser Dialog-Funktion da- 
mit die Forderung, sich auf dem Bildschirm als 
inaktiv zu markieren, was immer das im Fall der 
verschiedenen Objekte auch bedeuten mag. 

Der Verarbeitung von Tastatureingaben dient 
die TASTFKT. Sobald der Dialog-Manager — und 
nicht etwa ein Objekt selbst — eine Taste emp- 
fängt, reicht er diese an die TASTFKT des in die- 
sem Moment aktiven Objekts weiter. Wie das 
Objekt diese Taste verarbeitet, welche Verände- 
rungen sie innerhalb des Objekts auslöst, ist dem 
Dialog-Manager völlig egal. Für ihn zählt allein 
der Return-Code der Funktion, der ihn darüber 
in Kenntnis setzt, ob die Funktion die Taste ver- 
arbeiten konnte oder nicht. 

Dieser Return-Code muß einer der Konstanten 
TF_MAUS, TF_WEITER, TF_AKTIV etc. entspre- 
chen, die in der Include-Datei DLG.H definiert 
werden. Wurde die übergebene Taste verarbeitet, 
das eingegebene Zeichen also beispielsweise in 
ein gerade aktives Edit-Objekt aufgenommen, 
dann sollte die TASTFKT dem Dialog-Manager 
den Wert TF ACCEPTED zurückliefern. 

Wertet die TASTFKT die eingegebene Taste als 
Aufruf zur Aktivierung des nächsten oder vor- 
hergehenden Objekts (Tab und Shift-Tab), kann 
sie den Wert TF_FELD_VOR bzw. 
TF_FELD_RUECK zurückliefern. Der Dialog- 
Manager sucht in diesem Fall mit Hilfe der 
CANFKT nach dem nächsten zu aktivierenden 
Objekt und ruft, sobald er fündig wird, zunächst 
die DEAKFKT des bisher aktiven Objekts und die 
AKTIVFKT des neu zu aktivierenden Objekts auf. 

Konnte die Taste durch das aktive Objekt nicht 
verarbeitet werden, muß dem Aufrufer der Wert 
TF_WEITER übergeben werden. Er veranlaßt den 
Dialog-Manager, die Taste an alle anderen Ob- 
jekte weiterzureichen, bis ein anderes Objekt auf 
diese Taste reagiert oder sich herausstellt, daß 
kein Objekt auf diese Taste eingehen möchte. Da 
er für diesen Test jeweils wiederum die TASTFKT 
der verschiedenen Objekte aufruft, muß die 
TASTFKT grundsätzlich in zwei Modi arbeiten. 
Im ersten Modus (Objekt ist aktiv) versteht das 
Objekt den Aufruf der TASTFKT als Aufforde- 
rung, die Taste zu verarbeiten und reagiert in der 
bisher beschriebenen Art und Weise. 

Ist das Objekt beim Aufruf der TASTFKT aller- 
dings nicht aktiv, ist zuvor also kein Aufruf der 
AKTIVFKT erfolgt, sollte es diesen Aufruf als 
Frage des Dialog-Managers verstehen, ob die 
übergebene Taste zur Aktivierung des Objekts 
führen soll — sie also beispielsweise den Hotkey 
des Objekts widerspiegelt. Trifft dies zu, muß das 
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Objekt an den Dialog-Manager den Wert 
TF_AKTIV zurückliefern, um ihn zu seiner Akti- 
vierung aufzufordern. Andernfalls wird auch hier 
TF_WEITER übergeben, damit der Dialog-Mana- 
ger die Taste an andere Objekte zur Überprüfung 
weiterreicht. 

Werden Tastaturereignisse mit Hilfe der 
TASTFKT bearbeitet, so stellt jedes Objekt für die 
Behandlung von Mausereignissen die MAUSFKT 
zur Verfügung, die ganz wie die TASTFKT in 
zwei Modi arbeitet. 

Soweit ein Objekt noch nicht aktiv ist, genauer 
gesagt, nicht über die Maus aktiviert wurde, muß 
es den Aufruf dieser Funktion als Frage interpre- 
tieren, ob es sich durch das übergebene Maus- 
ereignis angesprochen fühlt, d.h. aktiviert wer- 
den möchte. 

Um diese Frage beantworten zu können, über- 
gibt der Dialog-Manager der MAUSFKT neben 
der aktuellen Position des Maus-Cursors auch die 
Event-Maske, die die Funktion KbmEventWait() 
(Abfrage von Maus und Tastatur) zurückgeliefert 
hat. Erkennt sich das Objekt als Adressat des 
Mausereignisses, muß es TF_MAUS zurücklie- 
fern, um aktiviert zu werden. 

Anderenfalls verlangt auch hier der Dialog- 
Manager die Rückgabe von TF_WEITER, damit 
er das Ereignis an ein anderes Objekt weiter- 
reichen kann. 

Ist das Objekt beim Aufruf der MAUSFKT hin- 
gegen bereits aktiv, so muß es auf das überge- 
bene Ereignis eingehen und - sofern es dieses 
Ereignis auf sich beziehen kann -— TF ACCEPTED 
zurückliefern. Anderenfalls veranlaßt die Rück- 
gabe von TF_WEITER auch hier den Dialog- 
Manager, sein Glück bei den anderen Objekten 
der Dialogbox zu versuchen. 

Liefern MAUSFKT oder TASTFKT einen ande- 
ren Wert als TF_WEITER, TF_ACCEPTED etc. zu- 
rück, versteht dies der Dialog-Manager als 
Aufforderung zum Schließen die Dialogbox und 
liefert den übergebenen Code als Return-Wert an 
den Aufrufer von DigStart() zurück. Wie wir im 
folgenden noch sehen werden, machen von die- 
ser Möglichkeit jedoch nur die Action-Buttons 
Gebrauch, die allein in der Lage sind, die 
Dateneingabe innerhalb einer Dialogbox zu 
beenden. 

Eine letzte Dialog-Funktion, die NEWVALFKT, 
ist bisher nicht zu Wort gekommen, weil sie vom 
Dialog-Manager selbst gar nicht aufgerufen wird. 
In Standard-Objekten, die miteinander nicht in 
Verbindung stehen, wird sie nicht benötigt und 
wird deshalb durch einen Dummy repräsentiert. 
Im Rahmen von Dialogboxen mit interdependen- 
ten Feldern kann sie jedoch von den Funktionen 
des Programmierers herangezogen werden, um 
dem Objekt mitzuteilen, daß sich sein Inhalt 
durch äußere Ereignisse verändert hat. Beispiele 
dafür werde ich den kommenden Folgen dieser 
Serie bei der weiteren Beschreibung der Dialog- 
objekte geben. 


[eeeemmtnnmenenbhennhentennn nenne / 


R DLEEDIT.C Pf 


I8 “/ 
" Aufgabe + Enthält die Funktionen zur Verwaltung von EDIT- “ 
I" Feldern, die innerhalb von Dfialog-Boxen zum Einsatz */ 
as kommen. “/ 
I Dieses Modul muß in Verbindumg mt dem DLG-Modul zum */ 
| Einsatz kommen. bi 
I* “/ 
I Autor » MICHAEL TISCHER ud 
I* entwickelt am : 13.07.1989 NY 
/* letztes Update : 17.07.1989 % 
pe ge re she De re EEE, 
I Erstellung » CL /ALSIMICILIH] DLGEDIT.C /C ” 
I" dann mit dem DL&-Modu) und anderen Moduln verbinden */ 


[eeeeemssemetetninhneennensnnee nen teren een 


I°— Include-Dateien einbinden ———— 1 / 


#include «string.h> 
#include memory.h> 
#include malloc.h> 
#include <dos.h> 
#inciude *dig.h* 


/*— interne Datenstrukturen des Dialogtyps DIT ——  / 


typedef struct /* diese Daten werden für jedes einzelne EDIT-Feld festgeh. */ 
{ 


BOOL aktiv, /* ist das Dialog-Feld gerade aktiv? */ 
maus, /* Tinker Mausknopf niedergedrückt? */ 
insert; /* zeigt INSERT-Hodus an */ 

BYTE pi /* Nr der Bildschirmspalte am linken Rand des E-Feldes */ 
Y /* Ausgabezeile */ 
xlinks, /* Nummer der ersten sichtbaren Eingabespalte */ 


xcur; /* Cursorpos. relativ zur linken Rand des Eingabefelds */ 
TASTE hotkey; /* ist 0, wenn das Feld keinen Hotkey besitzt */ 
EDITFELD d; /* die Daten aus der Edit-Struktur */ 
) EDITINTERN; 


typedef EDITINTERN * EDITP; /* Zeiger auf eine interne EDIT-Struktur */ 
Je Konstanten ————— — — — — / 


#define FILL_CHAR 255 
#define INSERT 338 


/* Füll-Zeichen zur Unterscheidung von Spaces */ 
/* INSERT-Taste, in KBM.H vergessen */ 


/*— Prototypen der EDIT-Funktionen, die in diesem Modul deklariert und in -*/ 
/*— der globalen Variable std _edit_fkt zusammengefaßt werden eh 


void * edit_start ( EDITFELD * dptr ); 

void edit_newval( EDITP ep, void * dptr ); 
void edit_ende ( EDITP ep ); 

BYTE edit taste ( EDITP ep, TASTE key ); 
void edit _deak ( EDITP ep ); 


DR 


void edit aktiv ( EDITP ep, BYTE why ); 
BYTE edit maus ( EDITP ep, BYTE x, BYTE y. BYTE ev ); 
B00L edit_can ( EDITP ep ); 


I*— globale Variablen, öffentlich ——— 1 / 
DLGFKT std_edit_fkt = /" Standard Dialog-Funktionen für */ 
{ /* ein EDIT-Dialogfeld ei 
edit_start, edit_newval, edit ende , edit_taste, 
edit“ _deak, edit. maus, edit aktiv, edit“ can 
hi 


ee ee 


“EDIT £s folgen die verschiedenen Funktionen des Dialogtyps EDIT * 
g ( alphanumerische Eingabefelder ) 


EEE Birnen sb re re EEE TERN 
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* Funktion »:EdSetMenge 
- 


: Dient einem Programm, das eine Dialog-Box erstellen 
möchte, bei der Definition der Eingabemenge für ein 
£dit-Feid 

Eingabe-Parameter: MPTR = Zeiger auf den Puffer der Eing: 

VON = ASCII-Code des ersten erlaubten Zeichens 

815 = ASCII-Code des letzten erlaubten Zeichens 


* Aufgabe 
. 


Return-Wert + keiner 

Info : De Funktion darf bellebig oft aufgerufen werden, um 
nacheinander verschiedene Zeichenbereiche als erlaubt 
zu markieren. 


Karsten nnnneren nennen seen ehren hen enter een er 


. 

. 

. 

. 
. . 
. . 
. . 
. . 
pi SET = TRUE wenn die Zeichen erlaubt sein sollen, 2 
° sonst FALSE : 
. . 
. . 
. . 
. . 
bi U 


void EdSetMenge( EMP mptr, BYTE von, BYTE bis, BOOL set ) 

{ 

int imin, /” Indexadressen für Zugriff auf den Mengen-Vektor */ 
max 

BE /* Schleifenzähler */ 


imin=-von+7»]3 
imax » bis - 7» 3; 
if ( imax > imin ) 


4* Inidizes für Zugriffe auf den Mengen- */ 

/* Vektor über MEMSET berechnen af 
f* wird mindestens ein Byte komplett belegt? */ 
I /" Ja, Bytes imin-imax setzen */ 
menset( mptr + imin, set ? Oxff : 0, imax - imin+1); 


/*— die Bits setzen, die vor IMN Hegen——  ___ ./ 
if({von&7)t=-0) /* gibt es Bits vor IMIN? */ 
/* ja */ 

if (set) /* Bits setzen? */ 
*(mptr + imin - 1) RE I" Ja ®/ 
eise ” Nein, Bits löschen */ 


re TEL CRERTTT: 
} 


/*— die Bits setzen, die hinter IMAX Hegen——— + / 


if ((bis87) 1-7) /* gibt es Bits hinter IMAX? */ 


Ir Ja */ 


if (set) /* Bits setzen */ 
*(mptr + imax + 1) |e (off «= (7-(bisk7)) ); ie da */ 
else /* Nein, löschen */ 


*(mptr + imax + 1) = *( aff<<e(7-(bisk7)) ); 


} 

else /* nein die Bits einzeln setzen */ 
if (set) /* Bits setzen oder löschen? */ 
for (i = von; I «bis ; + /* setzen */ 
“(mtr +(1»3)) |- etr-tarıın 

else f* löschen */ 
for (1 = von; i «bis ; 
*“aptr+(1>3))&="fı<(7-(187))); 


Jerwennumenntnenninnennnin nennen nenne 


* Funktion zedit_fi1N 


- .. 
* Aufgabe » Füllt den Eingabe-String eines Edit-Feldes auf seine * 
s maximale Länge mit dem Füllzeichen FILL_CHAR auf. = 
* Eingabe-Parameter: EP = Zeiger auf eine interne EDIT-Datenstruktur. u 
* Return-Wert : keiner = 
* Info : Diese Funktion findet nur intern Verwendung, sie wird * 
% nicht vom Scheduler aufgerufen, e 
EEE ee er reT, 


void edit_fill( EDITP ep ) 


BYTE Istr, /* Länge des Eingabe-Strings "/ 
len, /* maximale Länge des Eingabe-Strings */ 
* sp; /* Zeiger auf den Eingabstring */ 


/*— Eingabe-String mit gesperrten Leerzeichen (ASCII 255 ) auffüllen ——*/ 
Istr = strien( sp = ep->d.eingabe ); /" Länge des Eingabe-Str. ermitteln */ 
memset( sp + Istr, FILL_CHAR, ( Ten = ep->d.len ) - Istr ); /* auffüllen */ 
N sp + len) = '\0'; /* Ende-Markierung setzen */ 


een 


ELISE EIZS SET UTEESTEETTEI DIES PPESPPPSSPPEPPPESTPPSPPEPPPEeree Tee 
* Funktion vedit_shrink 
.. = E23 
* Aufgabe : Entfernt die bei edit_fill eingefügten Leerzeichen . 
® aus einem Edit-String wieder und schneidet den String * 
* nach dem letzten eingegebenen nicht-Füllzeichen ab. s 
* Eingabe-Parameter: EP = Zeiger auf eine interne EDIT-Datenstruktur. . 
* Return-Wert t keiner . 
* Info : Diese Funktion findet nur intern Verwendung, sie wird * 
« nicht vom Scheduler aufgerufen. \ 
/ 


un...........„..un„“eetenibenibeniieniieenieeieneiheneeneneneeene 


void edit_shrink( EDITP ep ) 


BITE 4, /* Schleifenzähler */ 
”1p, /" Laufzeiger in den Eingabestring */ 
”sp /* Zeiger auf den Anfang des Eingabestrings */ 


Ip = ( sp = ep->d,eingabe ) + ( i = ep>d.in ) - 1; /* von hinten nach */ 
for ( 541 88 "Ip == FILLCHAR: —i1, —Ip ) /* vorne suchen */ 
“(pr ) = \0t; /* String abschließen */ 
/*— alle vorhergenden FILL_CHARS In Spaces umandeIn —————t / 
for (: Ip>sp; —Ip ) /* den String bis zum Anfang durchlaufen */ 

tt 1p == FILL_CHAR ) /* FILL_CHAR entdeckt? */ 
N au) /* Ja, in Space umwandeln */ 


Jene een 


* Funktion sedit_ toggle_insert * 
.. 023 
* Aufgabe » Schaltet den Insert-Status eines EDIT-Feldes um und * 
3 definiert einen Block-Cursor, falls der INSERT-Modus * 
r aktiviert wird. u 
* Eingabe-Parameter: EP = Zeiger auf eine interne EDIT-Datenstruktur. nf 
* Return-kert : keiner 6; 
* Info t Diese Funktion findet nur intern Verwendung, sie wird * 
. nicht vom Scheduler aufgerufen. hd 
KAHhSnEHTEE EEE Renee nennen Eee eher 


void edit_toggle_insert( EDITP ep ) 


union REGS regs; /* Prozessorregister zum Interruptaufruf */ 
/*— Register CL und CH mit Start- und Endzeile des Cursors laden # 
regs.h.cl = WolsColor() ? 7 : 13; /* Cursor-Endzeile */ 
regs.h.ch » (ep->insert » tep->Insert) 70: regs.h.ci-1; /* Startzeile */ 
regs.h.ah = Ox0l; /* Cursor definieren */ 
ha 0x10, &regs, Aregs ); /* Video-B105 aufrufen */ 


[eremununuennnnnnennanenetenne een hehe een 


* Funktion sedit_ print 3 
[2 n .. 
* Aufgabe : Gibt den EDIT-String eines EDIT-Feldes auf dem Bild- * 
E schirm aus. ® 
* Eingabe-Parameter: EP * Zeiger auf eine interne EDIT-Datenstruktur. 9 
2 FARBE = Ausgabefarbe des Strings ” 
* Return-Wert : keiner , 
* Info : —- Diese Funktion findet nur intern Verwendung, sie A 
2 wird nicht vom Scheduler aufgerufen. 2 
" — Ausgabeposition und auszugebender Teil des EDIT- 4 
I Strings ergeben sich aus den Informationen in der . 
s übergebenen Datenstruktur. v 
Annnannusen ne nstennnneneneneen nen e nn en een a ee ee ee/ 


. edit_print( register EDITP ep, BYTE farbe ) 


BYTE merke, /* merkt sich ein Zeichen aus dem String */ 
* mpos, /* Zeiger auf das Merke-Zeichen */ 
* start; /* Ausgabeposition */ 
/*— Zeichen mit Hilfe von VioPrint ausgeben, indem hinter das letzte “| 
/*— suszugebende Zeichen eine Ende-Markierung geschrieben wird “| 


merke » ‚(aos = (start=ep->d.eingaberep->xlinks) + ep->d.visi ); 

*mpos = "\0' /* Ende-Markierung für Vioprint setzen */ 
Vioprint( px, ep->y, farbe, FALSE, start ); /* String ausgeben */ 
"mpos = merke; /* altes Zeichen zurückschreiben */ 


[mmmunnnnunnneennnsnneneneeenete nenne rennen 


* Funktion zsedit_start e 
- 


” Aufgabe » Wird vom Scheduler während der Initialisierung einer * 
hr Dialogbox für jedes EDIT-Feld aufgerufen. = 
* Eingabe-Parameter: DPTR = Zeiger auf den Datenblock des EDIT-Feldes. Id 
” Return-Kert : Ein Zeiger, den der Scheduler bei allen folgenden Auf- * 
he rufen den Funktionen edit_aktiv, edit_tast etc. über- * 

. 


pie * edit_start ( EDITFELD * dptr ) 


EDITP ep; /* Zeiger auf die anzulegende interne Datenstruktur */ 
BYTE farben, /* Ausgabefarbe für Feld */ 
farbe_h, /* Farbe des Hotkeys (soweit vorhanden) */ 
s /* nimmt Startspalte des Eingabefeldes auf */ 
2 {* nimmt Ausgabezeile auf */ 


/*— Speicherplatz für interne Struktur allok. und Struktur initialisieren */ 


ep = (EDITP) malloc( sizeof( EDITINTERN ) ); /* Speicherplatz allokieren */ 
z = ep>y = WO datr->y ); /* Ausgabezeile merken */ 
ep>alinks = ep->xcur = 0; /* Cursor am linken Rand des Feldes in Spalte 0 */ 
ep->maus = ep->aktiv = ep->insert = FALSE; /* alle Flags FALSE */ 


ep->d = *dptr; /* EDIT-Struktur kopieren */ 


Farben 


Mehrfach wurde bereits erwähnt, daß aktive Fel- 
der gehalten sind, sich innerhalb der Dialog-Box 
farblich hervorzuheben. Die dabei verwendeten 
Farben, müssen sie aus einer Struktur mit dem 
Namen DLGCOL beziehen, die innerhalb der 
Include-Datei DLG.H definiert wird. Hier finden 
sich neben der Farbe, mit der der Dialog-Mana- 
ger die Dialogbox füllt und den Rahmen um die 
Dialogbox zieht, noch die fünf folgenden Farben: 


nm Farbe für inaktive Dialogfelder und Texte 

hi Farbe für hervorgehobene Dialogfelder 

hk Farbe für den Hotkey innerhalb des Texts, 
der zu einem Objekt gehört 

da Farbe für Objekte, die nicht aktiviert werden 
können 

dk Farbe für den Hotkey in Objekten, die nicht 
aktiviert werden können 


Innerhalb des DLG-Moduls wird eine globale 
Variable vom Typ DLGCOL definiert, die den 
Namen dlgcol trägt und auf die sich nicht nur der 
Dialog-Manager, sondern auch die verschiedenen 
Objekte bei Ausgaben innerhalb der Dialogbox 
beziehen müssen. Bedienen können Sie sich dazu 
des Makros F(), das innerhalb der Include-Datei 
DLG.H definiert wird. Es ermöglicht den Zugriff 
auf die Komponente innerhalb der digcol- 
Variable, die dem Makro in Klammern übergeben 
wird. F(hi) liefert so den Inhalt von dlgcol.hi. 

Für den Monochrom-Modus ist digcol übrigens 
bereits initialisiert, aber wenn Sie sich anderer 
Farben bedienen möchten oder ein Color-Adap- 
ter angeschlossen ist, können Sie natürlich jeder- 
zeit andere Farbwerte in die einzelnen Kompo- 
nenten dieser Variable eintragen. 


Kleine Helferlein 


Neben DigStart() beinhaltet das DLG-Modul drei 
weitere Funktionen, die die verschiedenen Dia- 
log-Funktionen bei ihrer Arbeit unterstützen. Es 
sind dies die Funktionen DigPrint(), DigDelay() 
und DigBox(). 

DigPrint() hilft bei der Ausgabe des zu einem 
Objekt gehörenden Texts, indem es diesen Text 
nicht nur ausgibt, sondern gleichzeitig auch den 
Hotkey sucht, der durch ein vorangehendes »#«- 
Zeichen markiert wird. Den Tastaturcode dieses 
Hotkeys in Verbindung mit der Alt-Taste liefert 
es an den Aufrufer zurück. 

DigDelay() hält die Programmausführung für 
einen bestimmten Zeitraum an, was z.B. nach der 
Reaktion auf ein Mausereignis nützlich sein 
kann, damit sich dieses Ereignis nicht bereits im 
nächsten Augenblick wiederholt (etwa weil der 
Anwender den linken Mausknopf weiterhin nie- 
dergedrückt hält). Die Funktion bedient sich 
dazu der Funktion 00h des BIOS-Timer-Inter- 
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rupts 1Ah. Sie liefert die aktuelle Uhrzeit in Form 
eines Zählers zurück, der nach dem Systemstart 
18,2 mal in der Sekunde inkrementiert wird, bis 
er um Mitternacht wieder auf 0 gesetzt wird. 
DigBox() schließlich hilft bei der Gestaltung 
der Dialogbox, wenn es darum geht, einen Rah- 
men um eine Gruppe von Objekten zu ziehen 
und diesen Rahmen mit einem Titel zu versehen. 


Realisation der Objekte 


Neben dem Dialog-Manager finden Sie in dieser 
Folge bereits die Realisation des Edit-Objekts in 
der Datei DLGEDIT.C und der Action-Button in 
der Datei DLGAB.C. 

Beide Dateien enthalten nicht viel mehr als die 
vom Dialog-Manager benötigten Dialog-Funktio- 
nen und einige zusätzliche Hilfsfunktionen, die 
jedoch nur intern Verwendung finden. Für beide 
Arten von Objekten findet sich in DLG.H eine 
Struktur, die die benötigten Informationen für 
die Verwaltung der Objekte aufnimmt. Für Edit 
trägt diese Struktur den Namen EDITFELD und 
für die Action-Buttons heißt sie ABGROUP. Auf 
die Bedeutung der einzelnen Felder für die 
Definition des Objekts muß an dieser Stelle nicht 
weiter eingegangen werden — sie geht aus den 
Kommentaren in DLG.H eindeutig hervor. 

Einzig und allein der Typ EMENGE, den das 
Edit-Objekt zur Bestimmung der bei der Eingabe 
erlaubten Zeichen benötigt, bedarf hier noch 
einer Klärung. EMENGE wird als ein Vektor 
bestehend aus 64 Bytes definiert und stellt aus 
der Sicht des Edit-Objekts ein Bit-Feld mit 256 
Einträgen (64 Byte * 8 Bits = 256 Bits) dar. 
Jeder dieser Einträge korrespondiert mit dem 
Zeichen aus dem 256 Zeichen umfassenden 
ASCII-Zeichensatz des PC, das den Code der Bit- 
nummer trägt. Ist das entsprechende Bit gesetzt, 
darf das Zeichen eingegeben werden, sonst nicht. 

Um die Definition einer solchen Eingabemenge 
zu erleichtern, hält das Modul DLGEDIT die 
Funktion EdSetMenge() bereit. Ihr muß neben 
einem Zeiger auf die Eingabe-Menge nur die 
Nummer des ersten und letzten zu bearbeitenden 
ASCII-Codes sowie ein Flag übergeben werden, 
daß anzeigt, ob die adressierten Zeichen zur Ein- 
gabe erlaubt sein sollen oder nicht. Innerhalb der 
Eingabemenge setzt sie dann die entsprechenden 
Bits bzw. löscht sie. Und um die Arbeit mit dieser 
Funktion noch ein wenig komfortabler zu gestal- 
ten, enthält DLG.H verschiedene Makros 
(SetMengelnt, SetMengeAN, SetMengeDatei etc.) 
die die verschiedenen Aufrufe der EdSet- 
Menge()-Funktion erzeugen, derer es zur Defini- 
tion einer bestimmten Eingabemenge bedarf. 

Eine kurze Anmerkung auch noch zu den 
Action-Buttons: wie oben bereits erwähnt, kön- 
nen nur Action-Buttons zum Schließen der Dia- 
logbox führen. Damit der Aufrufer von DigStart() 
erkennen kann, welcher Action-Button aufgeru 


I"— Eingabefeld auf dem Bildschirm aufbauen ——  / 
farbe_n = ( dptrenabled ) ? Firm) : Flda); /" Ausgabefarbe festlegen */ 
farbe_h = ( dptr->enabled ) ? Fihk) : Fldk); /* Ausgabefarbe festlegen */ 


ep->hotkey = DigPrint( YL{ dptr->x ), z, dptr>text, farben, farbe_h ); 

s = VL( strien( dptr->text ) + dptrx + 1 ); /* Ausgabesp. im E-Feld */ 
if ( ep>hotkey I= NOKEY ) {* wurde ein Hotkey entdeckt? */ 
—; /* Ja, Spalte muß dekermentiert werden, weil '#' nicht zahlt */ 
VioPrint( (ep>x=s)-1, z, farben, FALSE, *[* ); /* Begrenzer ausgeben */ 
VioPrint( s + dptrvist „ z, farbe_n, FALSE, *]* ): 


]* Eingabestring auffüllen */ 
/* Inhalt des Eingabefelds ausgeben */ 
/* String in alte Form bringen */ 


edit_filil ep ); 
edit_print( ep, farben ); 
edit_shrink( ep ); 


return ep; /* Zeiger auf internen Datenblock zurückliefern */ 
) 

[erarnensnnsnnnnennnnnnnenensannsnensnnnennnenennennenennsenen nennen 
* Funktion sedit_newval “ 
.. . 


* Aufgabe ı Wird nicht direkt vom Scheduler, sondern von einer mit * 
® ihm zusammenarbeitenden Interaktions-Funktion aufge- * 
bu rufen, wenn sich der Inhalt eines EDIT-Feides durch ° 
bi äußeres Ereignis verändert hat. a 
* Eingabe-Parameter: EP = der Zeiger, der beim Aufruf von edit_start zu- * 
e rückgeliefert wurde, z 
* Return-Wert : keiner > 
° ! 


munnnennnnn nenne nern nennen nn 


void edit_newval( EDITP ep, void * dptr ) 
1 
} 


fernunnnennnnennnnnnneneanente nennen nenn anne ernennen rennen en 


* Funktion sedit_links x 
- . 
* Aufgabe : Bewegt den Cursor im Edit-Feld um eine Spalte nach > 
4 Vinks. y 
* Eingabe-Parameter: EP = der Zeiger, der beim Aufruf von edit_start zu- 

bi rückgeliefert wurde. = 
* Return-Wert : keiner in 
* Info : - Diese Funktion findet nur intern Verwendung, sie = 
« wird nicht vom Scheduler aufgerufen. ” 
Autnentneneennen nn nn Eee R Een En Rene RER R RER nenne nee een / 


void edit_links( EDITP ep ) 
{ 


/* Cursor am linken Rand des E-Felds? */ 
/* Nein, nur neue Pos. */ 
Ir Jar 

/® bereits erstes Zeichen sichtbar? */ 

/* Nein, Eingabefeld nach rechts scrollen */ 


if ( ep>xcur ) 
VioSetlursor( ep->x + —ep->xcur, ep->y ); 


else 
if ( ep>xlinks ) 
l 


—ep->alinks; 
edit_print( ep, F(hi) ); 
) 

} 


[enansunnnuenennansnnnnentennneenninnethenn anne enennenennen kennen 


/* Feld neu ausgeben */ 


* Funktion sedit_ rechts 

- . 
* Aufgabe : Bewegt den Cursor im Edit-Feld um eine Spalte nach “ 
u. rechts. F 
* Eingabe-Parameter: EP = der Zeiger, der beim Aufruf von edit_start zu- “ 
u rückgeliefert wurde. Fi 
* Return-Wert : keiner 2 
* Info : — Diese Funktion findet nur intern Verwendung, sie a) 
- wird nicht vom Scheduler aufgerufen. ‘ 
aerttenererenensn een r ee en en eneenn nee / 


void edit_rechts( EDITP ep ) 


{ 
if ( ep>acur I= ep->d.visi-1) /* Cursor am r. Rand? */ 
sg ep->x + HHep->xcur, ep>y ); /* Nein, nur neue Pos. */ 
/* Ja, bereits letztes Zeichen sichtbar? */ 
ae ( ep->xlinks < ep->d.len - ep->d.vist ) 
{ /* Nein, Eingabefeld nach links scrollen */ 
+ep->xlinks; 
edit_print( ep, F(hi) ); 
} 
} 


[ernnenunenninnnnnnnunnnnenen nern enter nern een ne 


* Funktion sedit_ende 


/* Feld neu ausgeben */ 


. 
. 
* Aufgabe : Wird vom Scheduler während des Schließens der Dialog- * 
& box aufgerufen, um EDIT Gelgegenheit zu geben, Clean- * 
. Up-Arbeiten durchzuführen. = 
* Eingabe-Parameter: EP = der Zeiger, der beim Aufruf von edit_start zu- * 
€ rückgeliefert mirde. N 
* Return-Wert + keiner u 

/ 


Kannnnnnnnennnenene ee EEE TUT TE TTTETenne 


void edit_ende( EDITP ep ) 


free( ep ); /* den allokierten Datenblock wieder freigeben */ 
} 


Jeeeeemennnnunnnsnntennnenneenenen hen 


* Funktion dit_taste 2 
.. 


* Aufgabe : Wird vom Scheduler aufgerufen, um dem Dialog-Feld eine.” : 
bu Taste zu übergeben. 

” Eingabe-Parameter: EP = der Zeiger, der beim Aufruf von edit_start zu- * 
h rückgeliefert wurde. 

. TASTE = Code der zu bearbeitenden Taste = 
* Return-Wert : Reaktionscode { . = 
snrensnenanenssnunnnnn en see naar en ee re FRnenen nenne nenn ernennen ne 


BYTE edit_taste( EDITP ep, TASTE key ) 


BYTE 1, /* Schleifenzähler */ 
zeichen, /* Zeichen an letzter Eingabepos. im INSERT-Modus */ 

*1p /* Zeiger zum Durchlaufen des Eingabestrings */ 
“sp, /* Zeiger auf den Anfang des Eingabe-Strings */ 
retcode; /* Return-Code */ 

if ( ep>aktiv ) /* ist das Dialog-Feld aktiv? */ 
ir Ja */ 


l 
MouHidekouse(); 


/* Maus-Cursor ausblenden */ 

switch ( key ) /* Taste untersuchen */ 
{ 

case TAB 2 I* Tab */ 

retcode = TF_FELD_VOR; 

break; 

case BACKTAB : I* BackTab */ 

retcode = TF_FELD_RUECK; 

break; 

case INSERT : I" Insert umschalten */ 


/* Insert-Status umschalten */ 
/* die Taste wurde akzeptiert */ 


edit_toggle insert( ep ); 
retcode = TF_ACCEPTED; 
break; 


case CLEFT : ir Cursor Tinks */ 
edit_links( ep ); 

retcode = TF_ACCEPTED; /* die Taste wurde akzeptiert */ 
break; 

case (RIGHT : I* Cursor rechts */ 


edit_rechts( ep ); 
retcode = TF_ACCEPTED; 
break; 


/* die Taste wurde akzeptiert */ 


case CHME : /* Cursor Home */ 
ep->xlinks = ep->xcur = 0; 

VioSetCursor( ep->x + ep>xcur, ep->y ); /* Cursor neu positionieren */ 
edit_print( ep, F(hi) ); /* Feld neu ausgeben */ 
retcode = TF_ACCEPTED; /* die Taste wurde akzeptiert */ 
break; 


case CEND B br Cursor End */ 
J*— letztes nicht FILL_CHAR-Zeichen schen ———  # / 


Ip = ep >d.eingabe + ( I = ep>d.len ) - 1; 
for ( ;i 88 "Ip =" FILL_CHAR: — 1, —Ip ) 


/* von hinten nach */ 

/* vorne suchen */ 

if (1 <ep>d.vist ) /" Ist Zeichen unter den ersten VISI-Zeichen? */ 
/* Ja, Eingabe ab erstem Zeilen darstellen */ 

ep>xlinks = 0; 

ep>xcr =-i; 

} 


else /* Nein, Eingabe so darstellen, daß sich der Cursor */ 
/* in der letzten Spalte des Eingabefeldes befindet */ 
ep>xlinks = I - ep->d.visi + 1; 
If (1 == ep->d.len ) 
—ep>xlinks; 
ep->xcur = ep->d.visi - 1; 


/* ist die letzte Pos. beschrieben? */ 
/" Ja, Cursor steht auf letztem Zeichen */ 
/* Cursor in letzte Ausgabesp. setzen */ 


edit_print( ep, F(hi) ): /* Feld neu ausgeben */ 
VioSetCursor( ep->x + ep->xcur, ep->y ); /” Cursor neu positionieren */ 


retcode = TF_ACCEPTED; /* die Taste wurde akzeptiert */ 


break; 

case DELETE : /* Delete */ 
Ip = ep->d.eingabe + ( 1 = ep>xlinks + ep->xcur ); 

memmove( Ip, Ipri, ep->d.len - 1 - 1); /* Zeichen heranziehen */ 


/"auffüllen®/ 
/* Feld neu ausgeben */ 
/* die Taste wurde akzeptiert */ 


*( ep->d.eingabe + ep->d.len — 1 ) = FILL_CHAR; 
edit_print( ep, F(hi) ); 
retcode = TF_ACCEPTED; 


break; 
case 8S € Backspace */ 
if ( ep>acur || ep>xlinks ) /* Cursor auf erstem Zeichen? */ 


{ /* Nein, Zeichen ab Cursorpos. um ein Zeichen nach links schieben */ 
Ip = ep->d.eingabe + ( i = ep->xlinks + ep->xcur ); 
memmove( \p-i, Ip, ep->d.Ten - 1); /* Zeichen heranziehen */ 
*( ep->d.eingabe + ep->d.Ien - 1) = FILL_CHAR; /"auffüllen*/ 
if ( ep>xcur ) /* Cursor am linken Rand des E-Felds? */ 
1 /* Nein */ 
—ep>xcur; /* eine Spalte nach links schieben */ 
VioSetCursor( ep->x + ep->xcur, ep>y ); /* Cursor neu pos. */ 
l 
else /* Ja, Eingabefeld nach rechts scrollen */ 
—ep>al inks; 
edit_print( ep, F(hi) ): /* Feld neu ausgeben */ 
] 
retcode = TF_ACCEPTED; 
break; 


/* die Taste wurde akzeptiert */ 


case CTRL_HOME: {8 — Ctrl + Home */ 
wenset( ep->d.eingabe, FILL_CHAR, ep->d.ien ); /* Eingabe-Str leeren */ 
edit_print( ep, F(hi) ): /* Feld neu ausgeben */ 


retcode = TF_ACCEPTED; /* die Taste wurde akzeptiert */ 
break; 
default : N dm — jedes andere Zeichen */ 


if ( key < 256 88 
(*(ep->d.mptr + (key >> 3)) & (1 «< (7 - (key & 7)))) ) 

{ /* das Zeichen darf laut Eingabemenge eingegeben werden */ 
1 = ep->xlinks + ep->xcur; f* Offsetposition in Eingbe-Str. ber. */ 
/* Zeiger auf akt. Pos. eim Eingabe-Str. */ 

/* Im Insert-Modus? */ 

/* Ja, letztes Zeichen muß noch leer sein */ 

if ( (zeichen = *(ep->d.eingaberep->d.len-1)) = ' * |] 

zeichen == FILL_CHAR ) 

{ /* letztes Zeichen ist noch leer */ 
if ei te ep>d.ien -1) /* Cursor auf letztem Zeichen? */ 
mermove( Ipti, Ip, ep->d.ien - i - 1); /"N, Zeichen wegschieben*/ 
*ip = key; /* Taste im Eingabe-Str, speichern */ 
if ( ep>xcur Ir ep->d.visi-1) /* Cursor am r. Rand? */ 

VioSetCursor( ep->x + ++ep->xcur, ep->y ); /* Nein */ 
else Ir Ja 
if (id te ep>d.len -1) /* Cursor auf letztem Zeichen? */ 
+ep>xlinks; /* ganzes Eingabefeld nach rechts scrollen */ 
edit_print( ep, Fiht) ); /" Feld neu ausgeben */ 
} 


} 
else /* nicht im Insert-Modus */ 


Ip = ep->d.eingabe + i; 
if ( ep>insert ) 


“Ip = key; /* Taste im Eingabe-Str. speichern */ 

if ( ep>xcur I» ep>d.visi-1) /* Cursor am r. Rand? */ 
{ /" Nein, nur das neue Zeichen ausgeben */ 
Vioprintf( ep->xtep->acur, ep->y, F(hi), FALSE, *4c*, (char) key); 
VioSetCursorf ep->x + rep->xcur, ep->y ); /Nein, nur neue Pos.*/ 
} 

else /* Ja, bereits letztes Zeichen sichtbar? */ 


ff ei teepmdien-1) 
+tep->xlinks; 
edit_print( en, Fihi) ); 
) 
} 


/* Nein, nach rechts scrollen */ 
/* Feld neu ausgeben */ 


retcode = TF_ACCEPTED; /* die Taste wurde akzeptiert */ 
else /* die Taste wurde nicht akzeptiert, weiterreichen */ 
retcode = TF_WEITER; 
break; 
) 
MouShowause() ; /* Maus-Cursor wieder anzeigen */ 
return retcode; /* Return-Code zurückiiefern */ 
) 
else /” Feld ist nicht aktiv, auf Hotkey testen */ 
return (ep->hotkey == key 58 ep->d.enabled) ? TF_AKTIV : TF_WEITER; 
} 
jreser ELLEIERee Teer er annnennennrerennn ernennen rennen error ernennen 
* Funktion sedit_ deak 5 
.$: FB Hr - Tu .. 
* Aufgabe : Wird vom Scheduler aufgerufen, um das Dialog-Feld von * 


seiner Deaktivierung in Kenntnis zu setzen. 
Eingabe-Parameter: EP = der Zeiger, der beim Aufruf von edit_start zu- 
rückgeliefert wurde, 


* Return-Wert : keiner 4 


wernnnnnennennee nenn nennen nn / 


fen wurde, werden die verschiedenen Buttons 
automatisch von O0 an durchnumeriert. Der Re- 
turn-Wert von DlgStart() spiegelt also die Num- 
mer des ausgewählten Action-Buttons wieder. 


DLGDEMO - 1989 by MICHEAL TISCHER 


DEMOBOX 


Null Problemo mit der Demo 


Das Demo-Programm DLGDEMO.C demonstriert 
die Deklaration der verschiedenen Datenstruktu- 
ren, die zur Beschreibung einer Dialogbox benö- 
tigt werden und die Arbeit mit der DigStart()- 
Funktion. Neben den in dieser Folge vorgestell- 
ten DLG-Modulen werden auch die Module aus 
den ersten beiden Folgen dieser Serie benötigt, 
die den Zugriff auf Maus, Tastatur und Bild- 
schirm abwickeln. 

Die verschiedenen DLG-Module sind nicht an 
ein bestimmtes Speichermodell gebunden und 
können daher an Ihre speziellen (Speicher-)Be- 
dürfnisse angepaßt werden. Erstellen Sie das 
DLGDEMO-Programm unter dem Speichermodell 
SMALL durch folgenden Aufruf Ihres Microsoft C 
Compilers: 


cl /AS digdmeo.c dig.c digedit.c dIgab.c vio.c kbm.c 


Das Wort zum Objekt 


Abschließend noch etwas Etymologie nach dem 
Motto »Woher hat das Objekt seinen Namen?«. 

Wer bereits mit den Ideen objektorientierter 
Programmierung vertraut ist, oder sich anhand 
des Artikels über QuickPascal in diesem Microsoft 
System Journal vertraut macht, der wird schnell 
feststellen, daß die Entwicklung einer Dialogver- 
waltung geradezu ein klassisches Anwendungs- 
gebiet objektorientierter Programmiertechniken 
darstellt. Dies ist kein Zufall, denn gerade die 
Probleme, die es bei der Entwicklung hochinter- 
aktiver Systeme wie SmallTalk, MS-Windows 
oder dem Presentation Manager zu meistern gilt, 
haben die Entwicklung objektorientierter Pro- 
grammiersprachen forciert. 


44 Listing 3: 
Fortsetzung 


Bild 3: 

Das Demo-Pro- 
gramm DLGDEMO.C 
demonstriert die 
Erstellung einer 
Dialogbox aus Edit- 
Feldern und Action- 
Buttons 
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Objektorientierte Programmiertechniken, etwa 
die Zusammenbindung von Daten und Pro- 
grammcode (Data Encapsulation) oder die Ver- 
erbung von »Attributen« (Inheritance), ließen 
sich wunderbar bei der Realisation einer Dialog- 
Verwaltung einsetzen. Und tatsächlich gleicht die 
Realisation der hier vorgestellten Dialogverwal- 
tung sehr stark dem Programmcode, den bei- 
spielsweise der C++-Precompiler von Glocken- 
spiel bei der Umsetzung von C++-Programmen 
in Standard-C-Code erzeugt. 

Wie aber würde der hier vorgestellte Dialog- 
Manager in einem objektorientierten C-Dialog, 
beispielsweise in C++, aussehen? 

Am Dialog-Manager selbst würde sich wohl 
wenig ändern, mehr dafür aber an der Repräsen- 
tation der einzelnen Objekte, die nun tatsächlich 
als Objekte im Sinne der Zusammenbindung von 
Programmcode und Daten formuliert werden 
würden. Welche Daten ein solches Objekt 
beinhaltet, wäre dabei für den Dialog-Manager 
nicht von Bedeutung, denn er kommt mit den 
Daten (auch in der nicht objektorientierten Ver- 
sion) gar nicht in Berührung. Wichtig für ihn ist 
lediglich, daß jedes Objekt bestimmte Methods 
(die bisherigen Dialogfunktion) bereitstellt, über 
die er mit dem Objekt kommunizieren kann. Da 
jeder dieser Methods automatisch als implizites 
Argument ein Zeiger auf die adressierte Instanz 
des Objekt-Typs übergeben wird, würde die 
Übergabe eines Zeigers, wie wir sie in den jetzi- 
gen Dialogfunktionen benötigen, entfallen. 

Hier würde der Compiler dem Programmierer 
also eine Menge Verwaltungsarbeit abnehmen 
und sich der Dialog-Manager und die einzelnen 
Objekte dadurch nicht nur übersichtlicher gestal- 
ten lassen, sondern auch die Fehleranfälligkeit 
reduzieren. 

Aber auch in anderer Hinsicht können die 
Ideen des objektorientierten Programmierens bei 
der Entwicklung einer Dialog-Verwaltung helfen. 
Dann nämlich, wenn es gilt, aus den einfachen 
Grundobjekten komplexere Objekte aufzubauen. 
Leicht ließe sich aus einem Edit-Feld z.B. ein 
numerisches Eingabefeld gestalten, indem das 
Num-Objekt mittels Vererbung aus dem Edit- 
Objekt hervorgeht, es dabei aber ein wenig modi- 
fiziert wird. Zunächst müßten die Variablen 
innerhalb des Objekts um eine Variable zur Auf- 
nahme eines numerischen Wertes ergänzt wer- 
den. Gleichzeitig werden Start- und Ende- 
Method so erweitert, daß die Zahl beim Aufruf 
der Start-Method zunächst nach ASCII umge- 
wandelt und das Ergebnis dieser Umwandlung 
dann in den Eingabe-String eingetragen wird. 
Dessen Inhalt wird beim Schließen der Dialog- 
box, und dem damit verbundenen Aufruf der 
Ende-Method, später wieder in eine Zahl umge- 
rechnet und in die Zahl-Variable eingetragen. 

Wie die vorliegende Dialog-Verwaltung zeigt, 
können diese Aufgaben auch mit tradierten Pro- 
grammiertechniken bewältigt werden, doch will 


void edit_deak( EDITP ep ) 


/*— farbliche Hervorhebung des Feldes zurücknemen ———————t/ 
Moukidekouse(); /* Maus-Cursor ausblenden */ 
VioPrint( ep->x-1, ep>y, Finm), FALSE, *[* ); 

VioPrint( ep->x + ep->d.visi, ep>y, Fi), „FASE, ); 

ep->xlinks = ep>xcur = 0; * Feld ab Position 0 darstellen */ 
edit_print( ep. F(nm) ); 
ep->maus = ep->aktiv = FALSE; 
if ( ep>insert } 
edit_toggle_insert( ep ); 
edit _Shrink( ep ); 


/* nicht mehr aktiv */ 

/* ist der Insert-Modus aktiv? */ 
/* Ja, abschalten */ 

/* String in alte Form bringen */ 


ViokideCursor(); /* Cursor vom Bildschirm entfernen */ 
MouShowMouse(); /* Haus-Cursor wieder einblenden */ 
[emensennsnnnenennsneenenen ine 
* Funktion sedit_ maus ir 
. er} 


* Aufgabe : Wird vom Scheduler aufgerufen, um dem Dialog-Feld ein * 
y Mausereignis zu übergeben 

* Eingabe-Parameter: EP » der Zeiger, der beim Aufruf von edit_start zu- * 
2 rückgeliefert wurde. in 
> % Y » Position des Mauscursors realtiv zu oberen F 
I linken Bildschirmecke 3 
% EV » Event-Haske, die das Ereignis beschreibt, um * 
hu dessentwillen die Funktion aufgerufen wird . 
* Return-Wert : Reaktionscode (TF_. f 


PPPPUeiDee RER HERNE HER DIE DOOR SPRRRREIRSEEREESE PETE Der 


BYTE edit_maus( EDITP ep, BYTE x, BYTE y, BYTE ev ) 
I 


/* ist das Feld bereits aktiv? */ 
/* Ja, Status des linken Mausknopfs feststellen */ 
/* wurde der linke Mausknopf losgelassen? */ 


it ( ep>aktiv ) 
if ( ev & EV_LEFTREL ) 
l 


ep->maus = FALSE; 

return TF_WEITER; /* Ja, Ereignis weiterreichen */ 
} 

else /* Nein, Mausposition auswerten */ 
if ( ep>maus ) /* auf Mausbewegung eingehen */ 
1 


/* Vinks vom Eimgeeto2 “/ 

ja */ 

/* Cursor eine Spalte nach Viola “4 
/* Programmausführung kurz anhalten */ 


if (x <ep> ) 


edit _links( ep ); 
MausPause(); 
} 
else 
if ex >= ep->x + ep->d.visi ) /* rechts vom Eingabefeld? */ 
Ir Ja */ 
/* Cursor eine Spalte nach rechts */ 


I 
edit _rechts( ep ); 
/* Programmausführung kurz anhalten */ 


MausPause(); 
else /* Cursor im Eingabefeld */ 
l 


/* Cursorspalte berechnen */ 


ep->xcur = x - ep>x; 
/* Cursor setzen */ 


VioSetCursor( ep->x + ep->xcur, ep>y )i 
return TF_ACCEPTED; 


else /* die Maus wird noch nicht überwacht */ 

{ /* befindet sich die Maus innerhalb des Eingabefeldes? */ 
if ( yemep>y bh x>uep->a Sb xe= ep->rtep->d.visi-i ) 
' I Ja */ 


/* Cursorpos. im Eingabefeld merken */ 
I» 


ep->xcur = X — px; 
Mausbewegung überwachen */ 


ep->maus = TRUE; 
return TF_ACCEPTED; 
) 


else /* Maus außerhalb des Eingabefeldes */ 
return TF_WEITER; 
} 


} 
else /* Nein, testen ob es jetzt aktiviert wird */ 


/* Tinker Maus-Button muß */ 


it ( (ev & EV_LEFT_PRESS ) [73 
[73 /* niedergedrückt sein und */ 


very 


x >= ep>x [1 /" der Maus-Cursor muß sich */ 
x «= ep->x + ep->d.visi -1 88 /* im Eingabefeld befinden */ 
ep->d.enabled } /* und Feld muß enabled sein */ 


l 

ep->xcur = x - ep; 

ep->maus = TRUE; 

return TF_MAUS; 

} 
else /* obige Bedingung wird nicht erfüllt, Event weiterreichen */ 
return TF_WEITER; 


! 


[eemensnensnnnsnnenentienneneehnn hen nn 


/* Cursorpos. im Eingabefeld merken */ 
/* Mausbewegung überwachen */ 


* Funktion sedit_can x 
.. . 
* Aufgabe : Wird vom Scheduler aufgerufen, um festzustellen, ob br 
s das Dialogfeld bereit ist, aktiviert zu werden. 2 
* Eingabe-Parameter: EP = der Zeiger, der beim Aufruf von edit_start zu- = 
. rückgeliefert wurde, 5 
* Return-Wert : TRUE, wenn das Dialog-Feld aktiviert werden kann, e 
br sonst FALSE ° 
Eeratnnssennsnnnernesen nennen een 


B00L edit_can{ EDITP ep ) 


return ep->d.enabled; {" ENABLE-Flag aus EDIT-Struktur zurückliefern */ 
l 


een een nn 


sedit_ aktiv 5 


* Aufgabe : Wird vom Scheduler aufgerufen, um das Dialog-Feld von * 
I seiner Aktivierung in Kenntnis zu setzen, 2 
* Eingabe-Parameter: EP = der Zeiger, der beim Aufruf von edit_start zu- ® 
n rückgeliefert wurde. . 
x WHY= warum wurde das Feld aktiviert. ® 
* Return-Wert : keiner « 
* Info + Der WHY-Parameter enthält eine der TF_...-Konstanten * 
° wie TF_FELD VOR, TF_MAUS etc. ei 
PEPPPEPPPPSSPPEPPPEEPPPETTEST POoec SOSE SEI oe EEE E77 
void edit_aktiv( EDITP ep, BYTE why ) 
F*— Dialog-Feid farblich hervorheben, Cursor anzeigen —t / 
if ( tep>aktiv ) /* ist das Feld bereits aktiv? */ 
/* Nein */ 


/* Maus-Cursor ausblenden */ 

if (why I» TFMAUS ) /* Aktivierung durch Maus? */ 
ep->xcur = 0; /* Nein, Cursor an linken Rand */ 

VioPrint( ep->x-1, ep->y, Fihi). FALSE, "[* 3: 

VioPrint{ ep->x + ep->d.visi, ep->y, Fihi), FALSE, ")* ); 

ep->xlinks = 0; /" Cursor steht am linken Rand des E-Feldes */ 

edit_filil ep ); /" Eingabesgtring auffüllen */ 

edit print( ep, Fihi) ); /* Eingabestring ausgeben */ 

VioSetlursor( ep->x + ep->xcur, ep->y ); 


MoukideMouse(); 


/* Feld ist jetzt aktiv */ 


ep->aktiv = TRUE; 
/* Naus-Cursor wieder einblenden */ 


MouShowMouse(); 


[ee 


ir DLGEAB,.C 7 
I" */ 
I Aufgabe : Enthält die Funktionen zur Verwaltung von Action- */ 
fr Buttons, die innerhalb von Dialog-Boxen zum Einsatz */ 
ge kommen . * 
ir Dieses Modul muß in Verbindumg mit dem DLG-Modul zum % 
Pd Einsatz kommen. 
fr 4 
8 Autor 3 MICHAEL TISCHER -/ 
J* entwickelt am : 13.07.1989 Ei 
gr letztes Update : 17.07.1989 2 
. . 
/* Erstellung : CL /ALSIMICILIH] DLEAB.C /C "7 
}- dann mit dem DLG-Modul und anderen Hoduln verbinden */ 
P Ichsichächchebeibulehelshlndecchuduhhehsichahehechhe hehe haha |; 
/*— Include-Dateien einbinden “/ 
#include «malloc.h> 
#include «string.h> 
#include "dig.h" 
/*— interne Datenstruktur des Dialogtyps AB (Action Button ) “/ 
typedef struct /* die Daten werden für jeden Action-Button festgehalten -*/ 
[ 
TASTE hotkey; /* Hotkey des Action Buttons (NOKEY = kein Hotkey) */ 
BYTE x1, x2, /* Start- und Endspalte des ABs */ 
Y /* Zeile */ 
xcur; /* Spalte für biinkenden Cursor */ 
} ABINTERN; 
typedef ABINTERN *ABIP; /* Zeiger auf eine interne AP-Struktur */ 
/*— Prototypen für Funktionen, die in diesem Modul deklariert und in der —*/ 
/*— globalen Variablen std_ab_fkt zusammengefaßt werden —/ 
void * ab_start ( ABGROUP * dptr ); 
void ab newval( ABIP abip, SH * dptr ); 
void abı ende ( ABIP abip ); 
BYTE ab_taste ( ABIP abip, TASTE key ); 
void ab _deak ( ABIP abip ); 
void ab. aktiv ( ABIP abip, BYTE why ); 
BO0OL ablı maus ( ABIP abip, BYTE x, BYTE y, BYTE ev ); 
BOOL ab_can ( ABIP abip ); 
/*— globale Variablen, öffentlich “/ 
DLGFKT std_ab_fkt = /* Standard Dialog-Funktionen für */ 
{ /* eine Gruppe von Action-Buttons */ 


ab_start, ab_newval, ab_ende , ab_taste, 
ab_deak, ab maus, ab aktiv. ab_can 
hi 


/*— globale Variablen, modulintern “/ 
static ABGROUP abg; /* dient den Funktionen für die Action-Buttons */ 
static BYTE aktab; /* aktueller AB */ 
static BOOL abaktiv; /* ist TRUE, wenn Innerhalb ABs */ 
static BOOL stdinvert; /* ist TRUE, wenn Standard-AB invertiert */ 
jemeemnnenennnenhneenatent ne ennee 
"AB £s folgen die verschiedenen Funktionen des Dialogtyps A 4 * 
. ( eine Gruppe von Action Buttons ) 
Hetennsereannenntr een Arne e ernennen ERST Ener anne n nen 
fessneerenueee: een “nn nennen 
* Funktion ab_testkey = 
.. .. 
Aufgabe : Stellt fest, ob die übergebene Taste einem der Action- * 
Buttons zugeordnet wurde, oder dessen Hotkey ent- ® 
spricht. ® 
Eingabe-Parameter: ABIP = Zeiger auf internen AB-Vektor « 
KEY = Taste = 


sonst die Nummer des Action-Buttons 
Diese Funktion findet nur Intern Verwendung, sie wird 
nicht vom Scheduler 


u... 


Info 


„nenn ne. 


hi ab_testkey( ABIP abip, TASTE key ) 


BYTE i; /* Schleifenzähler 
ABPIR labptr; /* Laufzeiger in Vektor mit AB-Daten 
/*— den Vektor mit den AB-Beschreibern durchlaufen 
for ( 1 = 0, labptr = abg.abp; 

1 < abg.anz && I(labptr->key == key A& Tabptr->enabled); 

++, +rlabptr ) 
HP CH == abg.anz ) /* Taste bereits entdeckt? 
l /* Nein, jetzt die Hotkeys untersuchen 


for ( 4 = 0; i < abg.anz 58 abip->hotkey I» key; ++1, +rabip ) 


Return-Wert : —}, wenn kein zugehöriger Action Button gefunden wurde,“ 


} 

getan {1 <abg.anz) Ti: -1l; /* 1 < abg.anz : gefunden! */ 
jeesununuunennnannnunnnennenenennnn seen nennen nenne 

* Funktion sab_mark r 
“ - 
* Aufgabe + Markiert einen Action-Button als gewählt oder nicht . 
” gewählt. » 
* Eingabe-Parameter: ABIP = Zeiger auf internen AB-Vektor ® 
" NR = Nummer des angesprochenen Action-Buttons x; 
5 MARK = TRUE, wenn es sich um den aktuellen Action- ei 
” Button handelt e 
* Return-Wert + keiner . 
* Info + — Mit dieser Funktion können nur Action-Button bear- * 
al beitet werden, die enabled sind. e 
© - Diese Funktion findet nur intern Verwendung, sie ® 
. 


wird nicht vom Scheduler aufgerufen. 


“ehhnnnnntstnnenenseeneee nern ernster een sent en een et he nnteeeten/ 


void ab_mark( ABIP abip, BYTE nr, BOOL mark ) 


register BYTE f, /* Ausgabefarbe 
5, /" Ausgabespalte 
2; /* Ausgabezeile 
MouHideMouse(); /* Maus-Cursor ausblenden 
abip #4 ar; /* den Beschreiber des angespr. ABs adressieren 


5 
“ 
= 


= 
el 


VioPrint( s = abip-xl, z » abip->y, f = mark ? F(hi) : Finm). FALSE, "<* ); 


Vioprint( abip>x2, z, f, FALSE, *>* ); 
DigPrint( s+i, z, (abg.abp+nr)->name, Firm), F(hk) ); 


if ( mark ) /* aktuellen Action Button markiert? 
VioSetCursor( abip->xcur, z ); /* Ja, Cursor darauf setzen 
if ( nr == abg.standard ) /* wurde der Standard-AB gezeichnet? 
stdinvert = FALSE; /* Ja, Standard-AB nicht mehr invers 
it /* Maus-Cursor wieder einblenden 


“/ 
Y 
/ 
“ 
$7 


dies nichts bedeuten, denn letztendlich kann 
man bei entsprechender Geduld auch die kom- 
plexesten mathematischen Berechnungen mit 
einem Abakus durchführen. Doch wer käme 
heute noch auf diese Idee? 

Michael Tischer 


s............nun.... 


. 
* Funktion :ab_invert 


werner seen 


* Aufgabe : Invertiert einen Action-Button 

* Eingabe-Parameter: ABIP = Zeiger auf internen AB-Vektor 

3 NR = Nummer des angesprochenen Action-Buttons 

* Return-Wert + keiner 

* Info : — Mit dieser Funktion können nur Action-Button bear- 
r beitet werden, die enabled sind. 

» - Diese Funktion findet nur intern Verwendung, sie 
ud wird nicht vom Scheduler aufgerufen. 


een 


void ab_invert( ABIP abip, BYTE nr ) 


{ 

abip += nr; /* den Beschreiber des angespr. Aßs adressieren */ 
MouttideMouse() ; /* Maus-Cursor ausblenden */ 
VioColor( abip->xl, abip->y, abtp->x2, abip->y, F(hi) ); 

VioSetCursor( abip->xcur, abip->y ); /* Cursor setzen */ 
MouShowMouse(); /* Maus-Cursor wieder einblenden */ 
if ( nr == abg.standard ) /" wurde der Standard-AB gezeichnet? */ 
stdinvert = TRUE; /* Ja, Standard-AB ist jetzt invers */ 

je EEE EEE Zen ||n;_;_;ee 

* Funktion sab_start > 


- — nd 


* Aufgabe : Wird vom Scheduler während der Initialisierung einer * 
. Dialogbox für die Gruppe der Action Buttons aufgerufen.* 
* Eingabe-Parameter: DPTR = Zeiger auf den Datenblock des Actions Buttons * 
* Return-Wert : Ein Zeiger, den der Scheduler bei allen folgenden Auf- * 
e rufen den Funktionen abaktiv, abtast etc. übergibt. 2 


EnesHnnnennenhen Ener Een era enn Renee eeneeen eh enneren ee tennennenee | 


void * ab_start ( ABGROUP * dptr ) 


l 

BITE 1, /* Schleifenzähler */ 
f; /* Ausgabefarbe */ 

char * sptr; /* Zeiger auf den Namen des Action-Buttons */ 

ABIP abip, /* Zeiger auf allokierten Vektor mit internen Infos */ 
labip; /* Laufzeiger in obigen Vektor */ 

ABPTR Nabptr; /* Laufzeiger auf einen AB-Beschreiber */ 

abg = *dptr; /* übergebene Struktur in globale Variable ABG kopieren */ 


4*— die einzelnen Action-Buttons aufbauen, Hotkeys und Pos. merken 


labip = abip = (ABIP) malloc( sizeof(ABINTERN) * abg.anz ); 
for ( Tabptr = abg.abp, 1 = abg.anz; 1 ; —i, ++labip, ++labptr ) 
{ /* den AB, auf den LABPTR zeigt, bearbeiten */ 
labip->x2 = VL{ labptr->x + strlen( labptr->name ) + 1 ); 
labip->hotkey = DigPrint( (labip->x1 = VL(labptr->x) ) + 1, 
labip->y = VO(labptr->y), 
sptr = labptr->name, 
f = labptr->enabled? F(nm) : F(da), 


labptr>enabled? F{hk) : Fldk) h 
4f ( 1labptr->enabled ) /* ist der AB disabled? */ 
labip>hotkey = NOKEY; /* Ja, es gibt keinen Hotkey */ 
1f ( Tabip->hotkey I= NOKEY) /* gibt es einen Hotkey? */ 
{ I" Ja */ 
—labip->x2; /* Hotkey-Zeichen nicht in Länge mitzählen */ 


labip->xcur = labip>xi + 1 + ( strchr( sptr, HOTKEY ) - sptr ); 
} 
else /* es gibt keinen Hotkey */ 
/* erstes nicht-Space im Namen des ABs suchen */ 
for { sptr = labptr->name; *sptr == ' '; +4sptr ) 


Yabip->xcur. = jabip>xl + 1 + ( sptr — labptr->name ); 
} 


— Begrenzer ausgeben —— — 
Vioprint( labip->xl, labip>y, f, FALSE, "<* ); 
Vioprint{ Tabip->x2, labip->y, f, FALSE, ">" ); 
) 


ab_mark( abip, aktab = abg.standard, TRUE ); /* akt. Button markieren */ 
abaktiv = FALSE; 4* aBs sind noch nicht aktiv */ 
return abip; /* Zeiger an Scheduler zurückliefern */ 


[eemnnennnnneneneennenesnnnnnennn nennen nennen nennen nennen een 
* Funktion :ab_newval i. 
ST 
* Aufgabe : Mird nicht direkt vom Scheduler, sondern von einer mit * 
® ihm zusammenarbeitenden Interaktions-Fukntion aufge- * 
S rufen, wenn sich der Inhalt eines EDIT-Feldes durch * 
> äußeres Ereignis verändert hat. bi 
* Eingabe-Parameter: EP = der Zeiger, der beim Aufruf von ab_start zurück- * 
= geliefert wurde. e 
* Return-Wert + keiner 2 


WERAAFIEEREEREERETH Anne een hauen haette ern neeee/ 


void ab_newval( ABiP abip, void * dptr ) 
\ 


[eruennnnnnennensnntunennnnntnnnnn enter nenne anne 


* Funktion :ab_ende 

a 
* Aufgabe » Wird vom Scheduler während des Schließens des Dialog- * 
8 box aufgerufen, um EDIT Gelgegenheit zu geben, Clean- * 
= Up-Arbeiten durchzuführen. br 
* Eingabe-Parameter: EP = der Zeiger, der beim Aufruf von ab_start zurück- * 
8 geliefert wurde, = 
. . 


Return-Wert ı keiner 


ee ren / 


void ab_ende( ABIP abip ) 

{ 

free( abip ); /* den allokterten Vektor wieder freigeben */ 
} 


[ernenennntenenennnnnnnnensnnenee nennen entre e een 


* Funktion zab_taste 2 
m I IE u 
* Aufgabe : Wird vom Scheduler aufgerufen, um dem Dialog-Feld eine * 
% Taste zu übergeben. e 
* Eingabe-Parameter: EP = der Zeiger, der beim Aufruf von ab_start zu- * 
E rückgeliefert wurde. = 
. . 


TASTE = Code der zu bearbeitenden Taste 
: Reakti { ) 
are Buestsnentene netten 


Listing 4: 
DLGAB.C 


SAAinC 
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Listing 4: 
Fortsetzung und Pi ab_taste( ABIP abip, TASTE key ) 


Ende ABIP labip; /* Laufzeiger in den internen AB-Vektor */ 
int retcode, /* nimmt Retum-Code auf */ 
neuakt; /* neuer aktueller AB */ 


If ( abaktiv ) /* sind die Ads aktiv? */ 

ir Jar 

switch ( key ) /* Taste auswerten */ 
1 


N 0, 78 SPACE wählt aktuellen Action Button aus —*/ 
labip = abip + aktab; /* Zeiger auf interne Infos zu aktuellen AB */ 
DigPrint(labip->x1+1, labip->y, (abg.abpraktab)->name, F(hi), F(hk)); 
return aktab; /* Terminstionscode ist Nummer des Action Buttons */ 

case AB : /* TAB führt zum nächsten Action-Button -*/ 

for ( neuakt = aktab ; 
+neuakt |= abg.anz 36 !(abg.abptneuakt)->enabled; ) 


if ( neuakt =» abg.anz ) /® auf letztem Action-Button? */ 
return TF_FELD VOR; /* Ja, ins nächste Dialog-Feld springen */ 
else /* Nein, auf nächsten Action-Button umschalten */ 


l 

ab mark( abip, aktab, FALSE ); /* aktuellen AB ausblenden */ 
ab mark( abip, aktab = neuakt, TRUE ); /* neuen AB einblenden */ 
return TF_ACCEPTED; /* Taste wurde verarbeitet */ 
} 


case BACKTAB : J*- BACKTAB führt zum vorhergehenden Action-Button */ 
for ( neuakt = aktab; 
—neuakt I" -1 A8 I(abg.abptneuakt)->enabled ; ) 


; 

if ( neuakt I" -1 ) /* auf erstem Action-Button? */ 
t /* Nein, auf vorhergehenden Action-Button umschalten */ 
ab mark( abip, aktab, FALSE ); /" aktuellen AB ausblenden */ 
ab mark( abip, aktab = neuakt, TRUE ); /* neuen AB einblenden */ 
return TF_ACCEPTED; /* Taste wurde verarbeitet */ 


} 
else /* Ja, zum vorhergehenden Dialog-Feld springen */ 
return TF_FELD RUECK; 


case CH I | ——— RETURN 9 / 
return ({ retcode = ab_testkey( abip, key ) ) I* —1 ) ? retcode 
 aktab; 


default : Ü— jede andere Taste -*/ 
return (( retcode = ab_testkey( abip, key ) ) I* -1 ) ? retcode 
: TFWEITER; 
} 


} 
else /* Action Button sind noch nicht aktiv */ 


if (key -- CR) /* wurde RETURN betätigt? */ 
return abg.standard; /" Ja, RETURN wählt den Standard-AB aus */ 
else /* Nein, ist ein AB mit dieser Taste verbunden? */ 
return (( retcode =» ab_testkey( abip, key ) ) I* -1 ) ? Tutcode 
TF_WEITER; 


[eeumnennnemnneneneenenen nennen teen nee een anne 


* Funktion :ab_deak 

ID nennen nennen 
* Aufgabe : Wird vom Scheduler aufgerufen, um das Dialog-Feld von 
” seiner Deaktivierung in Kenntnis zu setzen. 

* Eingabe-Parameter: EP = der Zeiger, der beim Aufruf von ab_start zurück- 
” geliefert wurde. 

* Return-Wert : keiner 


Kenskennenneeen een nee 


we ab_deak( ABIP abip ) 


i» 


Seren. 


4°— den Standard-Button aktivieren ——— / 


/* ist der bereits ausgewählt? */ 
]* Nein, alten ausblenden, neuen einblenden */ 
ab_mark( abip, aktab, FALSE ); 
ab mark( abip, aktab = abg.standard „ TRUE ); 


\ ( aktab I= abg.standard ) 


/* ABs nicht mehr aktiv */ 
/* Cursor vom Bildschirm entfernen */ 


} 
abaktiv = FALSE; 
VioHidelursor(); 


[erannnenneenenheeeeannen nennen een anne anne 


» Funktion :ab_maus ® 
[> BehıB a Es BB R  ok = Zar Te? PROBE Be TE" 
* Aufgabe : Wird vom Scheduler aufgerufen, um dem Dialog-Feld ein * 
® Mausereignis zu übergeben 2 
* Eingabe-Parameter: EP = der Zeiger, der beim Aufruf von edit_start zu- * 
® rückgeliefert wurde. on 
« X, Y = Position des Mauscursors realtiv zu oberen ® 
® linken Bildschirmecke = 
® Ev = Event-Maske, die das Ereignis beschreibt, m * 
® dessentwillen die Funktion aufgerufen wird ® 
* Return-Wert Reaktionscode (TF_...) ” 

! 


Fo at rerbne ES EERETEN 


BYTE ab_ maus ( ABIP abip, BYTE x, BYTE y, BYTE ev ) 


P» Listing 5: 'orre 1 
DLGDEMO.C ABI lahlor 


if ( abaktiv ) /* sind die Action-Buttons aktiv? */ 

Ir Ja” 

if ( ev & EV_LEFT_REL ) /* wurde der linke Mausbutton losgelassen? */ 

{ /*"Ja, feststellen, ob sich die Maus über einem AB befand */ 
for ( 1 = 0, labptr = abg.abp; i < abg.anz ; +1, ++abip, ++labptr ) 

if ( Nabptr>enabled A& yr-abip>y A z>sabip>xl 36 xabip>x2 ) 

return 1; 4* Ja, Dialog-Box beenden */ 

return TF_WEITER; /* Maus nicht über AB */ 


} 
else /* der Yinke Mausknopf ist noch niedergedrückt */ 
{ /* feststellen, ob sich die Maus noch über dem aktiven AB befindet */ 
labip = abip + aktab; /* Zeiger auf internen Beschreiber des akt. AB */ 
if ( ylelabip>y || x<labip>xi || x>labip->x2 ) 
{ /* Maus ist jetzt nicht mehr auf dem aktuellen Button */ 
/*— testen, ob sich die Maus über einem anderen AB befindet ar 


for ( 1 = 0, labptr = abg.abp, labip = abip; 
i < abg.anz ; 
+1, ++labip, ++labptr ) 
if ( labptr>enabled 88 y--labip->y 8 
»>=labip->xi B& x<slabip->x2 ) 
break; /* Maus über anderem AB */ 


/* Schleifenzähler */ 
/* Laufzeiger auf die einzelnen AB-Beschreiber */ 
/* Laufzeiger in Vektor mit internen Informationen */ 


/* Maus über einem anderen AB? » 
ir Ja” 

/* aktuellen AB ausblenden */ 

/* Ja, neuen invertieren */ 


u (1 1= abg.anz ) 


ab_mark( abip, aktab, FALSE ); 
ab_invert( abip, aktab = 1 ); 


else /* Nein, Standard-AB auswählen und markieren */ 
{* bereits auf Standard-AB */ 

/* Nein */ 
ab mark( abip, aktab, FALSE ); /* aktuellen AB ausblenden */ 
. aktab = abg.standard, TRUE ); 


if ( aktab I= abg.standard ) 
1 


SAAinC 
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else 
if ( stdinvert ) 
N ab mark( abip, aktab, TRUE ); 
} 
else /* noch auf dem gleichen Button */ 
if ( aktab == abg.standard &8 Istdinvert ) 
ab_invert( abip, aktab ); /* Std-AB war noch nicht invertiert */ 


return TF_ACCEPTED; 
) 


} 
else /* Nein, die ABs sind nicht aktiv */ 
if (ev & EV_LEFT_PRESS ) /* wurde der linke Mausbutton niedergedrückt? */ 
{ "/* ja, testen, ob sich die Maus über einem AB befindet */ 
for { 1 = 0, Tabptr = abg.abp; I < abg.anz ; ++, +abip, ++labptr ) 
if ( labptr>enabled 85 ymabip->y 58 Ksabip>xl s& x<=abip->a2 ) 
{ /" Maus befindet sich über einem enableden ABI */ 


/* Event wurde verarbeitet */ 


aktab = i; /* Nummer des ABs merken */ 
return TF_MAUS; /* AB aktivieren */ 
} 
return TF_WEITER; /* Maus nicht über einem der ABs */ 
} 
else /" Nein */ 


return TF_WEITER; 


LEE ET 


* Funktion :sab_can % 
EN Sr Un SE SE 
* Aufgabe : Wird vom Scheduler aufgerufen, um festzustellen, ob — * 
% das Dialogfeld bereit ist, aktiviert zu werden. “ 
* Eingabe-Parameter: EP » der Zeiger, der beim Aufruf von ab_start zurück- * 
x geliefert wurde. . 
* Return-kert + TRUE, wenn das Dialog-Feld aktiviert werden kann, 2, 
. 


sonst FALSE 
—_—————.————..———.,,GCmermmeeeeeeeeeeeeeee“, 
ag ab_can( ABIP abip ) 


return TRUE; /* ABs können aktiviert werden */ 
F Aduinisichubbchuiubabahahulshehe ha bsdehchhale ehulebchalahcdchsieieishuhehsiehulshsbehuleheta he inicielehhuiutelchiehulsiniehiehiekaheteieiahed 
* Funktion sab_aktiv ns 
EI | 
* Aufgabe : Wird vom Scheduler aufgerufen, um das Dialog-Feld von * 
« seiner Aktivierung in Kenntnis zu setzen. e 
* Eingabe-Parameter: EP = der Zeiger, der beim Aufruf von ab_start zurück- ® 
h> geliefert wurde. 

3 WHY = warum wird das Feld aktiviert . 
* Return-hert : keiner e 


Aeesnerteene een / 


void ab_aktiv( ABIP abip, BYTE why ) 

BYTE neuab; /* Nummer des neuen aktuellen Action Buttons */ 
abaktiv = TRUE; 
/*— Wurde der Aufruf durch eine TF_FELD_VOR- oder TF_FELD RUECK-Message —*/ 
/*— herbeigeführt, muß ein aktiver Actfon-Button ausgewählt werden. Bei —*/ 


/*— allen anderen Messages (TF_AKTIV etc.) wird davon ausgegangen, dad —*/ 
/*— bereits ein aktiver Action Button gewählt und seine Nummer inder —*/ 


{* ABs jetzt aktiv */ 


/*— Variablen aktab gespeichert wurde —_/ 
neuab = aktab; /* davon ausgehen, daß neuer AB bereits gewählt wurde */ 
switch ( why ) /* Grund des Aufrufs untersuchen */ 
{ 
case TF_FELD VOR /* ein Feld vor */ 


for (nevab » 0; Hlabg. abptneuab)->enabled; +neuab ) 
Baht 


case TF_FELD_RUECK : a eu. Feld zurück */ 


for ( neuab = abg.anz-1; !{abg.abprneuab)->enabled; —neua 
Be 


case TF_MAUS /* aktivierung durch Maus */ 
if ( aktab I= abg. etaodard ) /* wird der Standard-AB aktiviert? */ 
ab mark( abip, abg.standard, FALSE ); /* Nein, alten AB ausbi. */ 
ab_Invert( abip, aktab ); /* neuen AB Invertieren */ 
break; 
) 
if ( nevab I" aktab ) /" wurde ein neuer AB gewählt? */ 
{ /* Ja, alten ausblenden, neuen einblenden */ 
ab_mark( abip, aktab, FALSE ); 
ab_mark( abip, aktab = neuab, TRUE ); 
} 
else /* Nein, nur Cursor in AB setzen */ 
VioSetCursor( (abiptaktab)->xcur, (abiptaktab)>y ); 


feanmhnnnnnenennensenn 


e DLIEDEMO.C X 
|[P —— en 
/I* Aufgabe + Demonstriert die Erstellung und Verwaltung von Dia- */ 
Ir logboxen durch die Module DL6, DLGEDIT und DLGAB. Si 
e_————————— — — — nn. 
I* Autor : MICHAEL TISCHER “ 
/* entwickelt am : 13.07.1989 " 
y: letztes Update : 17.07.1989 x; 
Mm m . 
I* Erstellung + CL /ALSIMICILIH] DLGDEMO.C DLG.C DLGAB.C DLGEDIT.C */ 


iE v10.C KBM.C "/ 


ferreetennnn teten nern een near Ener / 
4*— Inctude-Dateien einbinden ———————— 05 
#include *dig.h* 


{*— Forward-Funktionsdeklarationen ————— 0 / 
void paint( void ); 


DLECOL demofarbe = /* Farben in der Dialogox für Color-Modus */ 


{ 

COL( WEISS, CYAN ), /* Rahmenfarbe # 
COL( SCHWARZ, CYAN ), /* normale Zeichen [7 
COL( GELB, SCHWARZ ), /* hervorgehobene Zeichen */ 
COL( ROT, CYAN ), /* Hotkeys u 
COL( HGRAU, CYAN). /* inaktive Felder % 


a HGRAU, CYAN ) 
fe— Daten für Eingabefeld | ——— 
BYTE fibuf[21] = "*; /* Eingabepuffer */ 
EMENGE fimenge; /* Eingabemenge */ 


EDITFELD tb_digfl = 


/* inaktive Felder, hotkey */ 


l 
TRUE, 3, 2, 20, 20, "alphasnumerisch : *, fibuf, flimenge 


/*— Daten für Eingabefeld #2 */ 
BYTE f2buffBl] = ""; I* Eingabepuffer */ 
EMENGE f2menge; /* Eingabemenge */ 
EDITFELD tb_digf2 = 

ar, 3, 4, 80, 23, "Dateiname „ fZbuf, f2menge 

/*— Daten für Eingabefeld #3 ud 
BYTE Fäbuf[il] = "1,23%; /* Eingabepuffer */ 
EMENGE f3menge; J* Eingabemenge */ 
EDITFELD tb_digf3 = 

; TRUE, 3, 6, 10, 10, *#integer *, fibuf, fimenge 


h 


Jr— Daten für die tin But tn ——— nn 1 


ONEAB tb_absdef[] =» 
l 
{ TRUE, 3,.9%° OK ®, 


{ TRUE, 22, 9, "ESC = #Abbruch*, 


{ TRUE, 48, 9, "Fl = sHilfe”, 
1 TRUE, 50, 4, * #tu dies ", 
{ TRUE, 50, 5, * tu dads *, 


NOKEY }, 


ESC }, 
Fl}, 
NOKEY |, 
NOKEY ) 


ABGROUP tb_abs = { 5, 0, tb_absdef }; 


ie 


Beschreibung der einzelnen Dialogfelder ”/ 


DLEDATEN tb_dfvek[] = 
t 


EDIT(tb_dIgfl), 
EDIT(tD: digf2), 
EDIT(tbd1973), 
ACHLLIR abs) 


Pr 


/* die Reihenfolge bestimmt auch die */ 
/* Reihenfolge, mit der die einzelnen */ 
/* Felder mit TAB und mit SHIFT TAB */ 
/* angesprungen werden können 7 / 


Beschreibung der Dialogbon ————— 4] 


DIGDES testbox = [ 8, 8, 65, 11, 4, paint, tb_dfvek }; 


DELETE TEE 


* Funktion zpaint ii 
.. . 
* Aufgabe : Wird von der Dialog-Prozedur DigStart während des id 
h) baus der Demo-Dialogbox aufgerufen. 

* Eingabe-Parameter: keine ® 
* Return-Wert : keiner p 


ee / 


void paint( void ) 


VioPrint( vL(28). vO(0), F(hi), FALSE, * DEMOBOX * ); 
Vioprintf( VL(0), vul-2), Fldigbox), FALSE, *Hisi", 
WR) - MA) 1) ); 

7, EINRA, * EDIT-Feider *, FALSE ); 
FALSE ); 


DlgBox( 1, 1, 45, 
OlgBox( 47, 2, 17, 6, EINRA, " Action Button *, 


l 


Jersunssonusnennannee 


/*== Hauptprogramm 


[Ponuunnussnnuunnanne 


/* Titel ausgeben */ 


VioStrep( ' 


Die PC-Referenz 
für Programmierer 
von Microsoft Press. 

Alle wichtigen und 
nützlichen Informatio- 
nen rund um den PC sind 
auf 535 Seiten und in fast 

700 Tabellen aus techni- 
schen Referenzbüchern, 

Systemdokumentationen 

und Programmierhandbü- 

chern ausgewertet und in die- 
sem Buch zusammengetragen 
worden. U, a. Übersichten aller 

DOS-, BIOS-, EDLIN-, DE- 

BUG- oder Windows-Kommandos mit allen zulässigen Parametern. 
Die Zentralregister für alle, die intensiv mit dem PC umgehen. Mit 
deutschem und englischem Index. 
Thom Hogan: Die PC-Referenz für Programmierer 
ISBN 3-89390-250-3 - 535 Seiten - DM 69,— 


Auslieferung Schweiz: Thali AG, Industriestr. 6, 
Ch-6285 Hitzkirch, Tel.: 041/852828 


void main( void ) 
{ 


/* wimst Nr. des ausgewählten Action-Buttons auf */ 
/* Koordinaten des OK-Buttons im Hilfe-Fenster */ 


BYTE auswahl; 
BEREICH bereich; 
BOOL ende; 
Yiolnit(); /* die SAA-Modul WIO und KBM initialisieren */ 
Kbminit(); 


SetMengeAN( flmenge ); 
SetMengeDatei( f2menge }; 
SetMengeint( f3menge ); 


if ( Violscolorf) ) /* ist ein Color-Adapter angeschlossen? */ 
digcol = demofarbe; /* Ja, Farbeinsteliungen für Dialogbox vornehmen */ 
VioClearScreen( VWiolsColor() ? COL{ WEISS, BLAU ) : NORMAL ); 
VioClear( 0, 0, anzcol-1, 0, ViolsColor() ? COL( WEISS, ROT) : 
VioPrint( 22, O0, ViolsColor() ? COL{ WEISS, ROT ) : INVERS „ 
"DLGDEMO — (c) 1989 by MICHEAL TISCHER"); 

MouShowlause(); /* Maus-Cursor anzeigen */ 
do /* Eingabeschleife */ 


/* die drei Eingabemengen initialisieren */ 


INVERS ); 
FALSE, 


auswahl = DigStart( ätestbox ); /* Digbox aufb., 
if ( auswahl = 2) 


Eingaben entgegennehmen */ 

/* Hilfetaste betätigt? */ 
Ir dar 

/*— Hilfe-Fenster öffnen und aufbauen —— / 

MouHideMouse(); /* Maus-Cursor ausblenden */ 

VioWinOpen( 40, 16, 73, 24 ); 

Vioframe( VL(0). v0(0), VR(O), Vu(0). DOPRA, F(digbox) ); 

VioClear( VL(1), volı), VR(-1), vUl-1), Fam) ); 

Vioprint( VL(13), vO(0), F(ht), FALSE, * Hilfel * ); 

VioPrint( VL(7), VO(2), Finm), FALSE, "Bitte \x11-] betätigen" ); 

Vioframe( VL(21), WO(5). VR(-3), VUl-1), EINRA, Fldigbox) ); 

VioPrint( vL(25), vO(6), Finm), FALSE, "OK" ); 

MouPushPara(); 

bereich.xl = VL(21); 

bereich.yl = vol 5); 

bereich.x2 = VR(-3); 

bereich.y2 = W(-1); 

bereich.ptr_mask = MouPtrMask( PTRDIFCHAR( 251 ), PTRDIFCOLB( 0x70 ) ); 

MouSetBereich( 1, äbereich ); /* das OK-Feld definieren 

ende = FALSE; 

MouShowlouse(); 

do 


/* Mausparameter sichern 
/* Position des OK-Felds setzen 


{ /* auf Event warten 
If ( KimEventWait( EV_LEFT PRESS | EV_KEY_AVAIL ) & EV_KEY_AVAIL ) 


ende = ( Kbdßetkey() == CR ); /* Taste. Ist @s Return? 
else /" Tinker Mausknopf niedergedrückt 
if ( MoußetBereich() == O ) /* im OK-Feld? 
( /* Ja, auf Loslassen des Buttons warten 
KbmEventWait( EV_LEFT_REL ); 
ende = TRUE; 


) 
} 
while ( ende ); 


MouPopPara(); /* alte Mausparameter restaurieren 
HouHideMouse() ; /* Maus-Cursor ausblenden 
VioWinClose( TRUE ); 

MouShowkouse() ; 


} 
) 
while ( auswahli»O && auswahli=i ); 
MouHideMouse(); /* Maus-Cursor wieder ausblenden 
VioSetCursor( 0, 0 ); /" Cursor in obere linke Bildschirmecke 


} 


Programmierung 
unter Windows 
Für alle, die mit Win- 
dows Anwendungen er- 
stellen und den An- 
schluß an die professio- 
nelle Software-Entwick- 
lung nicht verlieren wol- 
len. Das Buch führt schritt- 
weise und mit praktischen 
Beispielen in die Windows- 
Programmierung ein. Es prä- 
sentiertübersichtlichundleicht 
verständlich die wichtigsten In- 
formationen aus der umfangrei- 
chen Dokumentation zu Mikrosofts Windows. Incl. zwei Disketten 
mit allen Beispielprogrammen im Quellcode. 
Tim Farell: Programmierung unter Windows 
Ein Leitfaden für die Software-Entwicklung unter Windows Vers. 
2.0 und Windows /386, 
ISBN 3-89390-251 - 1 


- 483 Seiten incl. 2 Disketten. DM 98.— 


IM BUCHHANDEL ERHÄLTLICH 


VER 


Kreillerstraße 156 


Listing 5: 
Ende 


*/ 
y. 


“ 


“ 
7 


7 
*/ 


THEMA 


G6MBH 


LAG 


Telefon: 089/431 30 93 
Telefax: 089/431 56 33 


8000 München 82 
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Strukturen, Unions und typedef- 
Deklarationen: 


Daten- 
organisation 
in C- 
Programmen 


Sicherlich haben die meisten von 
Ihnen beim Programmieren in C 
schon Strukturen, Unions und 
typedef-Deklarationen benutzt. Im 
allgemeinen sind Strukturen ein- 
fach zu handhaben und unterstüt- 
zen geradezu beispielhaft den kor- 
rekten Umgang mit Daten. Ferner 
dienen sie dazu, den Code lesbarer 
und wartungsfreundlicher zu ge- 
stalten. Mit Unions und typedef- 
Deklarationen kann man dies auch 
erreichen, doch ist ihr Gebrauch 
schwieriger und wird leicht 
unübersichtlich. 


el der Gebrauch der Unions und 

Strukturen schon ziemlich weit verbreitet 
ist, will ich hier auf die grundlegende Syntax (die 
Regeln, mit denen sie innerhalb der Sprache C 
aufgebaut werden) und Semantik (ihre Bedeu- 
tung) nicht näher eingehen. Statt dessen sollen 
hier einige typische Eigenarten, die beim Ge- 
brauch auftreten, beschrieben werden. Dem 
Leser soll damit geholfen werden, Programmier- 
fehler zu vermeiden, Probleme der Übertragbar- 
keit (Portabilität) von Programmen zu erkennen 
und überhaupt die Sprache C ein wenig besser 
verstehen. 


Neue Entwicklungen 


Der ursprüngliche Sprachumfang von C wurde in 
dem Klassiker »The C Programming Language« 
von Brian W. Kernighan und Dennis M. Ritchie 
(im folgenden: K&R) beschrieben. In dieser 
Sprachdefinition waren Wertzuweisungen an 
Strukturen, Strukturen als Argumente und Funk- 
tionen, die Strukturen zum Ergebnis hatten, 
nicht erlaubt. Heutige Compiler hingegen lassen 
solche Anweisungen zu. Diese Sprachelemente 
wurden in den Normungsvorschlag des »Ameri- 
can National Standard Institue for C« (ANSI C) 
aufgenommen. Dieser Vorschlag soll, soweit ich 
weiß, nicht mehr überarbeitet werden und dürfte 
bald als allgemeiner Standard anerkannt sein. 

Ein anderes neues Charakteristikum, das in 
dem Normungsvorschlag aufgenommen wurde, 
ist das Initialisieren automatischer Strukturen. 
Allerdings ist es nicht in allen Compilerversionen 
verfügbar, besonders in denen nicht, die übli- 
cherweise im Xenix- und Unix-Compiler Ent- 
wicklungspaket enthalten sind. Zum Beispiel 
würden solche Compiler die Struktur-Deklaration 
in Listing 1A nicht akzeptieren. Hier muß man 
zusätzlich eine static-Vereinbarung hinzufügen 
(siehe Listing 1B). 

Dies ist für den Programmierer umständlich; 
der Grund liegt eigentlich nur darin, daß eine 
ältere Sprachversion zugrunde gelegt wird und 
ist nicht etwa durch Zwänge, die sich aus der 
Compilerkonstruktion ergeben, begründet. Diese 
Einschränkung kann Sie als Programmierer aber 
auch dazu zwingen, mehr statischen Speicher- 
platz zu belegen, als Ihnen lieb ist. Wenn es auf 
Speicherplatz ankommt, kann das schon proble- 
matisch werden. Als Alternative bietet sich 
eigentlich nur das explizite Zuweisen von Werten 
an die einzelnen Elemente der Struktur im Code. 
In Bezug auf Geschwindigkeit ist das auch uner- 
heblich, denn beim Erstellen des lauffähigen 
Programms macht der Compiler nichts anderes, 
jedoch wird Ihr Programm dadurch nicht gerade 
lesbarer. Bei automatischen Unions und arrays 
tritt dieses Problem ebenfalls auf. Sie sind zwar 
möglich, jedoch von ANSI nicht vorgeschrieben. 
Da sie aber allgemein üblich sind und durch die 


main() 
{ 
struct { 
int a; 
heil}; 


WARTET 


main() 
{ 
static struct { 
int a; 
Is=-{1b 


nusuneng 


main() 


struct { 
int a; 
} si, s2; 


if (si =" s2) /* syntaktischer Fehler */ 
printf(*s1 == s2\n*); 

else 
printf("s1 != s2\n"); 


onanawunn 


un 
5 


Normierung unterstützt werden, würde ich mir 
den Kauf von Compilern, die sie nicht ermögli- 
chen, zweimal überlegen. 


Der Vergleich von Strukturen 


Versuchen Sie das Programmbeispiel aus Listing 
1C zu kompilieren. Wie Sie sehen, meldet der 
Compiler einen syntaktischen Fehler. Dieser 
Fehler entsteht dadurch, daß man Strukturen 
und auch Unions nicht als Ganzes auf Gleichheit 
überprüfen kann (im Gegensatz zur Wertzuwei- 
sung struct1 = struct2, die erlaubt ist). Die ein- 
zige Möglichkeit zwei Strukturen zu vergleichen, 
ist der Abgleich jeder einzelnen Komponente. 

Das hört sich erstmal nach einer unnötigen 
Einschränkung beim Gebrauch von Strukturen an 
(so wie die umständliche Initialisierung). Aber es 
gibt sogar zwei Gründe dafür: Zum einen wäre 
zu erwarten, daß außer Vergleichen auch Prü- 
fungen auf Ungleichheit (!=), relationale Opera- 
toren (>, <, <=, >=) und vielleicht noch ganz 
andere Dinge erlaubt sind. Und das ist nicht 
unbedingt wünschenswert, weil dadurch der 
Compileraufbau sehr kompliziert würde. Darüber 
hinaus kann es durchaus vorkommen, daß eine 
Struktur extrem viel Speicherplatz belegt (darauf 
gehe ich nachher noch genauer ein) und die 
Erzeugung von fehlerfreiem Code mehr als 
umständlich wird (ganz besonders bei den rela- 
tionalen Operatoren). Außerdem wird es außer- 
ordentlich schwierig, bei Cross-Kompilierung, 
genauer der Cross-Assemblierung, bestimmte 
Fehler aufzuspüren. 


Zugriff auf Struktur-Elemente 


In C gibt es zwei Operatoren, die den Zugriff auf 
die einzelnen Elemente ermöglichen, und den 
meisten Programmierern wird ihr Gebrauch auch 


nicht besonders schwer fallen. Es sind . (Punkt) 
und -> (Pfeil). Den Punkt benutzt man, um 
direkt auf ein Element zuzugreifen (bei Struktu- 
ren und Unions). Erfolgt der Zugriff über einen 
Zeiger, der auf die Struktur oder Union weist, 
wird der Pfeil benutzt. Im Zusammenhang mit 
anderen Operatoren jedoch scheint manchmal 
einige Verwirrung zu herrschen. Die größten 
Probleme tauchen offenbar beim Gebrauch von & 
(Adresse von) und * (Verweisoperator) auf. Für 
Anfänger sind Konstellationen wie &*p-> ebenso 
verständlich wie Hieroglyphen. In Listing 2 sind 
einige Beispiele aufgeführt, und nicht nur Anfän- 
ger werden bei einigen Anweisungen ihre 
Schwierigkeiten haben, genau sagen zu können, 
was gemeint ist. 


struct s { 


1 

2 int y 

3 int *%; 

4 } 

5 

6 struct s foo; 

7 struct s *pfoo = Afoo; 

8 

9 main() 

10 { 

11 printf(*%d\n, foo.x); 

12 printf(**d\n, pfoo->x); 
13 printf("sd\n, Apfoo->x); 
14 printf("*d\n, *pfoo->x); 
15 printf("sd\n, &foo.x); 
16 printf("%d\n, *&pfoo>x); 
17 printf("id\n, &*pfoo->x); 
18 printf("*d\n, sizeof(int)); 
19 printf(*%d\n, &foo); 


Der Gebrauch der einzelnen Operatoren zum 
Zugriff auf Struktur-Komponenten richtet sich 
ganz besonders nach der Priorität der Operato- 
ren. In der Liste der Prioritäten (mehr darüber 
finden Sie in der Sprachbeschreibung des 
Microsoft C Compilers 5.1, den ich im folgenden 
MSC nenne) stehen Punkt und Pfeil ganz oben 
(sie werden also zusammen mit den Klammern 
O0) und [] vorrangig verarbeitet). Daran sollte 
man stets denken. Die Priorität ist auch, wie im 
»Komplexe C-Deklarationen verständlich ge- 
macht«, Micorsoft System Journal (Jg.3, Heft 1) 
beschrieben, ein wichtiger Hinweis zum Ver- 
ständnis von C-Anweisungen. Überhaupt ist die 
Kenntnis der verschiedenen Prioritäten eine 
grundlegende Voraussetzung für C-Programmie- 
rer. Es ist natürlich wesentlich einfacher, Pro- 
gramme zu lesen, zu schreiben und zu pflegen, 
wenn man sich dieser Prioritäten stets bewußt ist 
und nicht ständig nachschlagen muß. Das kann 
gar nicht oft genug betont werden! 

Listing 2 dürfte nun verständlicher sein. Das 
Problem liegt wahrscheinlich in Zeile 13. Verfolgt 
man diese Anweisung Schritt für Schritt, so sollte 
man zum Ergebnis kommen, wie es im Listing 3 
angegeben ist. In Zeile 12 wird die Adresse des 
Elements x ermittelt, auf dessen Struktur pfoo 
indirekt zeigt. Allgemein weist pfoo->x auf das 
Element x einer Struktur. Es wird also nicht die 
Adresse von pfoo als Zeiger auf die Struktur mit 
dem Element x benutzt. 
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&(pfoo—x) 
*(pfoo—x) 
&(foo.x) 
&(*(pfoo->x)) oder einfach pfoo->x 
*(&(pfoo->x)) oder einfach pfoo->x 


nun 


In Zeile 14 wird der Wert von x ermittelt. 
Dabei ist x Komponente der Struktur, auf die 
pfoo zeigt. Das ist deshalb möglich, da x als int*- 
Variable deklariert wurde. Allerdings wird nicht 
der Wert der Variablen pfoo als struct-Zeiger be- 
nutzt, um x zu referieren. Ansonsten müßte es 
das gleiche sein wie pfoo->x, was ganz offen- 
sichtlich nicht funktioniert. 

Zeile 16 ist besonders interessant, weil sich 
einige der Operatoren gegenseitig aufheben. An- 
genommen, x ist als int deklariert. Nun können 
wir *&x codieren. Zuerst wird die Adresse von x 
berechnet und in einer int* Variable abgelegt. 
Danach wird der durch diesen Wert adressierte 
Inhalt des Speichers ermittelt. Natürlich hätte 
man statt dessen auch einfach auf x zugreifen 
können. So etwas ähnliches passiert in Zeile 16. 
Es wird der Inhalt der Adresse von pfoo->x be- 
stimmt. (Beachten Sie hierbei wieder die Priori- 
täten der Operatoren!) 

Zum Schluß betrachten wir Zeile 17. Obwohl 
sie sich etwas von Zeile 16 unterscheidet, ist das 
Ergebnis identisch, wenn auch etwas schwieriger 
zu verstehen. Sehen wir uns also Listing 4 an. 
Man sollte erwarten, daß &*pvar in Zeile 10 das 
gleiche bedeutet wie &9999, weil *pvar dem 
Wert 9999 entspricht (natürlich ergibt das so 
keinen Sinn, weil man schlecht die Adresse einer 
Konstanten angeben kann). Wenn wir also *pvar 
als Adresse des Inhalts von pvar interpretieren, 
ist das Ergebnis &var, da var der Inhalt von pvar 
ist. Mit dieser Argumentationsweise wird auch 
Zeile 17 in Listing 2 erklärt. 


1 main() 

2 { 

3 int var = 9999; 

a int *pvar = Avar; 
5 

6 printf("%d\n, pvar); 
7 printf("*d\n, *pvar); 
8 printf("%d\n, Apvar); 
9 printf("%d\n, *Apvar); 
10 printf("*d\n, &*pvar); 
11 printf(*\n); 

12 printf("%d\n, var); 

13 printf("d\n, &var); 
14 printf("*d\n, *&var); 
15 printf("*d\n, A*&var); 
16 printf(*&d\n, *8*Bvar); 


Die Zeilen 15, 18 und 19 dienen dem Selbst- 
studium. Wie würden die Format-Anweisungen 
aussehen, wenn x als *char definiert wäre? 


Die Speicherorganisation 
von Strukturen 


Eine andere unangenehme und etwas unver- 
ständliche Erscheinung beim Umgang mit Struk- 


turen ist ihre Größe. Grundsätzlich ist das, was 
man sieht, nicht unbedingt identisch mit dem, 
was tatsächlich vorhanden ist. Aber wieso sollte 
das den Anwender interessieren? 

Ich möchte das Problem am nächsten Pro- 
grammbeispiel (siehe Listing 5) näher erläutern. 
Wenn das Programm auf einem 80386-Rechner 
abläuft, erhält man die angegebenen Ergebnisse. 
Sizeof(char) ergibt 1 und sizeof(int) ergibt 4 als 
Byte- bzw. Wortlänge auf einem 80386-Rechner 
(unter Unix und beim Large-Modell unter DOS). 
Bei der Angabe der Größe von chara und charb 
geht auch alles glatt, nur scheint bei huh irgend 
etwas nicht zu stimmen. Es handelt sich jedoch 
weder um einen Programmierfehler, noch um 
eine Macke im Compiler. Wir sind hier auf ein 
Phänomen gestoßen, das in C zu Recht als 
undefiniert gilt. In unserem Beispiel belegt huh 
acht Bytes statt der erwarteten fünf, weil intb 
vier Bytes belegt und auf einer Wort-Adresse, die 
durch vier teilbar ist, liegen muß. Der Compiler 
schiebt deshalb nach dem einem Byte, das chara 
belegt, drei undefinierte Bytes ein, damit die intb 
auch wirklich an der richtigen Stelle aufhört. 


1 #define offsetof(type, identifier) (&l((type *)0)-\ 
>identifier)) 

2 

3 main() 

4 { 

5 struct chara ( 

6 char chara; 

7 IB 

8 

9 struct charab | 

10 char chara; 

11 char charb; 

12 b 

13 

14 struct huh { 

15 char chara; 

16 int intb; 

17 }; 

18 

19 struct huh2 { 

20 int intb; 

21 char chara; 

22 h 

23 

24 printf("%d\n, sizeof(char)); 

25 printf("d\n, sizeof(int)); 

26 

27 printf(**d\n, sizeof(struct chara)); 

28 printf("%d\n, sizeof(struct charab)); 

29 printf("*d\n, sizeof(struct huh)); 

30 printf("sd\n, sizeof(struct huh2)); 

31 

32 printf(*&d\n, offsetof(struct charab, charb)); 

33 printf("sd\n, offsetof(struct huh, intb)); 

34 printf("sd\n, offsetof(struct huh2, intb)); 


Die Ausgabe dieses Programs auf einem 80386-Rechner lautet: 


o»2-oonrn- ar 


Dadurch, daß man die Komponenten einfach 
umdreht, wird der Speicherplatz allerdings auch 
nicht besser ausgenutzt. Das wird deutlich, wenn 
man die Größe von huh2 betrachtet. Liegt hier 
nun eine Schwäche des Compilers vor, der nicht 
optimiert arbeitet, oder gibt es dafür einen ver- 
nünftigen Grund? Stellt man sich ein Array vom 


Typ huh2 vor, dann sieht man, daß diese Art der 
Speicherbelegung notwendig ist, damit alle Feld- 
elemente auf einer Wort-Adresse beginnen. 

Geht man einen Schritt weiter, so bedeutet 
das, daß auch jede Struktur im Speicher so aus- 
gerichtet ist, eine Tatsache, die auf den ersten 
Blick wohl nicht so offensichtlich ist. Durch diese 
Art der Ausrichtung wird allerdings zur Ausfüh- 
rungszeit kein Speicher belegt, sie ist nur zur 
Anpassung an die Systemumgebung notwendig, 
tritt also so nicht auf allen CPUs auf. Bei einigen 
Systemen werden Variablen nur auf geradzahli- 
gen Adressen abgelegt, bei anderen auf Vielfache 
von 2, 4, 8, ... Bytes. Wieder andere erlauben 
zwar, die Art der Ausrichtung zu wählen, und 
bieten damit eine nicht so strenge aber dafür 
auch nicht so effiziente Ausrichtung. Microsoft C 
(MSC) Version 5.1 bietet diese Option, die Sie 
aktivieren können, wenn der Speicher zu stark 
fragmentiert ist und dadurch Speicherplatz 
knapp wird. Sie kann durch Setzen des /ZP- 
Schalters in der Kommandozeile oder durch die 
#pragma pack-Anweisung im Programmcode 
ausgewählt werden. Zu beiden Alternativen fin- 
den Sie genaueres im Benutzerhandbuch (Kapitel 
3.3.15) des Microsoft C Optimizing Compiler 
Version 5.1. 


Das Lesen und Schreiben 
von Strukturen 


Es ist häufig notwendig, eine Struktur in einer 
Diskettendatei oder im RAM abzulegen (oder 
einem Kanal oder einer anderen Interprozess- 
Kommunikation in Betriebssystemen wie OS/2, 
Xenix oder Unix). Da ein Programm, das auf 
diese Struktur zugreift, nicht notwendigerweise 
mit den gleichen Compileroptionen erstellt 
wurde oder sogar auf einer anderen Maschine 
läuft als jenes, das Daten in die Struktur hinein- 
schreibt, ist es oft sinnvoll, mit einem kleinen 
Programm die Werte der Strukturen auszugeben 
(einen Dump erzeugen). Man kann nicht einfach 
davon ausgehen, daß die Daten richtig sind. 
Denn, wie oben dargestellt, entstehen durch die 
Angleichung der Adressen Löcher, die die physi- 
kalische Anordnung der Struktur verändern. 
Eigentlich kann man von gar nichts ausgehen, 
ohne sich den Quellcode und die Compileroptio- 
nen genau anzusehen. 


Die Bestimmung des Offsets 


Hardwareabhängige Konstanten im Programm zu 
verwenden, wird allgemein als schlechter Pro- 
grammierstil angesehen. Wegen der unter Um- 
ständen auftretenden Ausrichtung der Strukturen 
im Speicher ist es weder schön noch portabel, 
den Offset einer Komponente in einer Struktur 
durch hardwareabhängige Werte darzustellen. 


Kehren wir noch einmal zum Listing 5 zurück. 
Wie wir gesehen haben, ist es nicht ganz einfach 
zu bestimmen, in welchem Byte intb beginnt. 
Statt es direkt anzugeben, sollten Sie lieber das 
offsetof-Makro verwenden. 

Das offsetof-Makro steht bei den meisten 
neueren Compilern zur Verfügung und befindet 
sich in der Datei <stddef.h>. An dieses Makro 
werden als Parameter die Struktur und die Kom- 
ponente übergeben. Als Ergebnis wird der Offset 
dieses Elements, gerechnet vom Anfang der 
Struktur, in Byte zurückgegeben. Listing 5 ent- 
hält eine mögliche Implementation dieses 
Makros (#define offsetof in Zeile 1), die auf den 
meisten Rechnern funktionieren sollte. Die 
grundsätzliche Idee hinter diesem Makro ist die 
Annahme, daß die Struktur ab Adresse O beginnt 
[folglich (type*)0], und somit eine Referenz auf 
eine beliebige Komponente den relativen Offset 
in Byte ergibt. Zum Experimentieren mit Struktu- 
ren können Sie die Anweisungen aus Listing 5 
benutzen. 


Typenanpassung 


Bis jetzt haben wir uns hauptsächlich mit Struk- 
turen beschäftigt. Ein weiteres Sprachelement 
von C sind Unions, die vom syntaktischen Aufbau 
Strukturen sehr ähnlich, in der Bedeutung jedoch 
völlig anders sind. Leider wird ihre Wirkungs- 
weise in C-Programmen oft falsch verstanden. 

Um das zu erläutern, werde ich erst einmal 
darlegen, was Unions sind und was sie nicht sind 
(vielleicht besser nicht zu sein scheinen?). Eine 
Union ist eine Variable, die zu einem bestimmten 
Zeitpunkt ein (und genau ein) Objekt vieler ver- 
schiedener benannter Objekttypen beinhalten 
kann (also Objekte, deren Speicherplätze sich 
überlappen), unabhängig vom Typ dieser Ob- 
jekte. Daraus lassen sich folgende Schlüsse zie- 
hen: 

° Zweck von Unions ist es, Speicherplatz oder 
Variablen mehrfach zu verwenden. 

® Alle Komponenten einer Union sind an dersel- 
ben Startadresse im Speicher abgelegt. 

° Die Größe einer Union wird durch die Größe 
ihrer größten Komponente festgelegt. 

° Nur ein einziger Komponentenwert kann in 
einer Union abgelegt sein. 

° Aus Gründen des Programmierstils sollten Sie 
sicherstellen, daß alle Komponenten der Union 
einer speziellen logischen Einheit des Programms 
zugeordnet ist, in der sie benutzt werden. 

Damit stellen Unions ein nützliches Hilfsmittel 
zur Typangleichung und zur Neudefinition von 
Typen dar. Auf die Neudefinition gehe ich im 
nächsten Abschnitt ein, zunächst soll es um die 
Typangleichung gehen. 

Bei der Systemprogrammierung ist es oft not- 
wendig, bei der Benutzung von Systemresourcen, 
Einheitentreibern oder bestimmter Hardware 
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(z.B. DMA) Datenformate anzupassen. C als die 
De-facto-Standardsprache zur Systemprogram- 
mierung stellt dafür Unions zur Verfügung. 

Wir können zum Beispiel davon ausgehen, daß 
die meisten Betriebssysteme oder Einheiten auf 
Wortgrenzen arbeiten (was, um genau zu sein, 
bei den meisten Maschinen eine Begrenzung auf 
geraden Adressen bedeutet). Weiterhin können 
wir mit einiger Sicherheit annehmen, daß eine 
Hardwareeinheit Informationen mit einer Länge 
von 6 Byte erwartet. Wenn wir nun einfach eine 
Variable als char info[6] deklarieren, so ist es 
keineswegs sicher, daß der C-Compiler diesen 
Wert auf einer geraden Speicheradresse ablegt. 
Damit haben wir gerade eine 50 prozentige 
Chance — und noch ungleich geringere, den Feh- 
ler zu finden, wenn 6 Monate später das Pro- 
gramm geändert wird. 

Um das Problem zu lösen, also die Variable 
sicher auf einer geraden Speicheradresse abzu- 
legen, deklariert man sie in der folgenden Weise: 
union device data { 


int dumm; /* ausrichten */ 
char info[6]; 


Da dummy eine gerade Adresse besitzt, und 
alle Komponenten einer Union auf derselben 
Startadresse beginnen, liegt info auch auf einer 
Wortgrenze. Natürlich brauchen Sie sich in 
Ihrem Programm um den Wert dummy nicht 
mehr zu kümmern, er hat seinen Zweck erfüllt 
und wir das Problem doch recht elegant gelöst, 
oder? 


Redefinitionen - 
Zweckentfremdung 
von Unions? 


Da C nicht vorschreibt, wie Unions verwendet 
werden sollen, besonders die Benutzung von nur 
einer Komponente zu einer bestimmten Zeit 
keine zwingende Einschränkung der Sprache ist, 
bleibt dem Programmierer überlassen, wie er 
damit arbeitet. Mit anderen Worten: Sie können 
die Struktur einer Union einsetzen, wie es am 
zweckmäßigsten ist. Sie müssen nur daran den- 
ken, daß die einem Wert zugeordnete Kompo- 
nente nur solange verfügbar ist, bis eine andere 
Komponente der Struktur zugewiesen wird. Das 
Problem besteht eben darin, daß in C dafür kei- 
nerlei Kontrollen vorgesehen sind und sich der 
Programmierer innerhalb der syntaktischen 
Granzen frei entfalten kann. 

Ist zum Beispiel deklariert: 


union example | 
int 1% 


so wird bei den folgenden Anweisungen kein 
syntaktischer Fehler auftreten: 


ex.d = 999.999; 
I 


Allerdings können Sie davon ausgehen, daß j 
keinen vernünftigen Wert enthält, wenn Sie nicht 
gerade eine Zufallszahl erzeugen wollten. Trotz 
allem ist es bei einiger Umsicht durchaus mög- 
lich, diese Nebeneffekte sinnvoll zu nutzen. Dann 
sollte man aber zum einen völlig verstanden 
haben, was passiert, und außerdem sauber und 
ausführlich dokumentieren! 

Im letzten Jahr habe ich zum Beispiel an 
einem Auftragsprojekt gearbeitet, bei dem das 
Betriebssystem RMX von Intel eingesetzt wurde. 
Es lief auf einem 80386-Rechner, also einer Ma- 
schine mit einer segmentierten Architektur. 
Irgendwann benötigten wir den Zugriff auf dyna- 
mischen Speicherplatz. Aus einem ziemlich 
kuriosen Grund hat es sich gezeigt, daß keine der 
Standardroutinen von C (z.B. malloc) zur Pro- 
blemlösung geeignet war. Statt dessen verwen- 
deten wir eine RMX-Systemroutine, um den 
Speicher zu erhalten. Daraus ergab sich das Pro- 
blem, daß wir als Ergebnis dieser Routine ein so- 
genanntes Token erhielten, das sich bei jedem 
Routinenaufruf als Startadresse eines Segments 
herausstellte. Das Token enthielt also jedesmal 
die zwei Byte der Segmentadresse, nicht jedoch 
den Offset innerhalb des Segments (ebenfalls 
zwei Byte), dabei benötigten wir dieses Token als 
Zeiger auf einen Character. Unsere Lösung war 
ein kleines Programm, das so ähnlich aussah wie 
in Listing 6A. Allerdings ist es aus den oben ge- 
nannten Gründen keineswegs sicher, daß es mit 
allen Compilern läuft. Außerdem gingen wir da- 
von aus, daß pointer == int zulässig ist. Darüber 
hinaus ist die Anordnung von Offset- und Seg- 
mentadresse innerhalb der Variablen systemab- 
hängig, da die interne Darstellung von Worten 
und Bytes von der Hardware abhängt. Daran 
sieht man recht deutlich, daß die ganze Lösung 
nicht besonders sauber ist. 


#define getmemory() 20 /* simulierter RSX-Aufruf */ 


1 

2 

3 char . 

4 toktopr(token) 

5 short token; 

6 { 

7 union { 

8 struct [ 

9 short offset; 

10 short segment; 

11 } segoff; 

12 char *ptr; 

13 } convert; 

14 

15 convert.segoff.segment = token; /* hole Segmentnummer */ 

16 convert.segoff.offset = 0; /* Offset im Segment ist Null */ 

17 

18 return (convert.ptr); /* exakte Übernahme des Zeigers 
auf Segment und Offset */ 

19 } 

20 

21 main() 

22 { 

23 int token = getmemory(); /* RSX Speicheraufruf */ 

24 char *p = toktoptr(token); 

25 

26 printf("%d\n*, p); 


27 } 


#define getmemory() 20 /* simulierter RSX-Aufruf */ 


1 

2 

3 char * 

4 toktopr(token) 

5 short token; 

6 { 

7 return ((char *) ((long(token) << (sizeof(short) * 8))); 
8 

9 

10 main() 

11 { 

12 int token = getmemory(); /* RSX Speicheraufruf */ 
13 char *p = toktoptr(token); 

14 


15 printf("sd\n*, p); 
} 


Trotz allem ist eine derart einfache Umwand- 
lungsroutine erstaunlich funktionsfähig. Bevor 
wir uns aber zu sehr darüber freuen, sollten wir 
uns die bevorzugte Methode der Typangleichung 
ansehen, die cast-Operation. Listing 6B ist eine 
Version der toktoptr-Umwandlung, die mit cast- 
Operationen arbeitet. Diese Lösung sieht zwar 
nicht gerade besonders schön oder elegant aus 
und ist auch durch ein paar getroffene Annah- 
men nicht ohne weiteres portabel, zeigt aber sehr 
deutlich, daß Unions zur Redefinition benutzt 
werden können, dieses aber einige schwere 
Nachteile mit sich bringt. Wenn Unions nicht zu 
ihrem eigentlichen Zweck als mehrfach nutzbare 
Speicher verwendet werden, ist es ganz einfach 
nicht zulässig und vollkommen nichtportabel, 
sogar zwischen verschiedenen Compilern auf 
demselben Rechner. Es ist darüber hinaus nicht 
einmal auszuschließen, daß optimierende Com- 
piler inkorrekten Code aus den nicht zulässigen 
Anweisungen erzeugen. Die Verwendung von 
cast-Operationen ist die, obwohl auch systemab- 
hängige, im allgemeinen weniger problematische 
Methode und außerdem »legales« C. 

Der Grund, diese Nebeneffekte so ausführlich 
darzustellen ist nicht, Ihnen neue Programmier- 
tricks aufzuzeigen, sondern Sie auf schlechten 
Programmierstil hinzuweisen und Sie vorzuberei- 
ten, falls Ihnen derartiger Code beim Bearbeiten 
oder Pflegen eines Programms vorkommen sollte. 
Wenn Sie sich doch entscheiden, etwas Ähnliches 
selbst zu codieren, kennen Sie jetzt die Probleme 
und was passieren kann. 


Der allgemeine 
Gebrauch von Unions 


Eine weitere Anwendung von Unions ist das Er- 
zeugen von codierten Records. Es ist zulässig, in 
einer Union einen gültigen Variablennamen zu 
deklarieren, und somit innerhalb einer Union 
eine Struktur zu verwenden (und umgekehrt). 
Listing 7 enthält ein Beispiel zur Verarbeitung 
eines bestimmten Records, der etwa über eine 
Kommandozeile o.ä., eingegeben wurde. Jeder 
Record besitzt eine Kennung int recordtype, mit 
der, abhängig vom Aussehen des Records, der 
Programmablauf über die switch-Anweisung ge- 
steuert werden kann. Im zugehörigen Programm- 


teil werden dann die entsprechenden Komponen- 
ten des Records bearbeitet. Damit bietet C eine 
sehr elegante und wartungsfreundliche Methode, 


«44 Listing 6B: 
Programmbeispiel 
aus 6a in Standard- 
C umgeschrieben 


um Datenstrukturen verarbeiten zu können, die 
ohne unnötigen Speicherplatz oder Zeiger auf 
komplizierte Datenstrukturen auskommen. Ins- 
besondere ist es möglich, im Gegensatz zum 
oben Besprochenen, den ersten int-Wert der 
Struktur coderecord ganz problemlos wiederzu- 
verwenden. Darüber hinaus bieten sich überlap- 
pendende Strukturen noch einen weiteren Vor- 
teil: Sind bei sich überlappenden Strukturen 
innerhalb einer Union die Anfangskomponenten 
gleich, kann man z.B. die eine Komponente be- 
schreiben und den Wert aus der anderen lesen. 
Wenn etwa die Strukturen typel und type2 iden- 
tisch aufgebaut sind, ist es durchaus zulässig, 
einen beliebigen Wert in a zu speichern und da- 
nach c zu benutzen, ohne daß irgendwelche 
Nebeneffekte auftreten können. Die Komponen- 
ten a und c sind vom gleichen Datentyp und lie- 
gen auf demselben Offset innerhalb der Union. 
Vom Programmierstil ist es übrigens sauberer, 
die Komponenten a, c und e aus der Union her- 
auszulösen und als einzige Komponente der 
Struktur genericrecord zu verwenden. Allerdings 
hängt dieses ganz wesentlich vom logischen Zu- 
sammenhang zwischen den Bezeichnern im Pro- 
grammcode ab. 


voasownawun. 


#include <stdio.h> 


union codedrecords 


h 


«Listing 7: 
Verbundene unions 
und structs 


struct 
int a 


float b; 
} typel; 
struct { 

int 6 

long d; 
} type2; 
struct { 

int e; 


int f; 
) type3; 


struct genericrecord | 


h 


int recordtype; 
union codedrecords cr; 


struct genericrecord gr; 


main() 


{ 


Man) 


switch(genericrecord.recordtype) { 
case TYPEI: 

/* Anweisungen mit genericrecord.cr.typel.? */ 
break; 


case TYPE2: 
/* Anweisungen mit genericrecord.cr.type2.? */ 
break; 


case TYPE3: 
/* Anweisungen mit genericrecord.cr.type3.? */ 
break; 


default: 
fprintf(stderr, "Falscher Recordtyp!!!"); 
exit (1); 
break; 


} 
Deseeh 


Noch eine letzte Anmerkung zu Unions: ob- 


wohl in der Vorschlagsliste des ANSI C die Initia- C 
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>> Listing 8: 
Vergleiche zwischen 
#define und typedef 
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lisierung von Unions erlaubt ist, sind hier zwei 
Einschränkungen zu beachten. Zum einen darf 
nur durch Konstanten initialisiert werden, die 
zweitens nur die erste Komponente festlegt. Dar- 
auf sollten Sie ganz besonders achten, wenn Ihr 
Compiler den Typ konvertiert und die Zuweisung 
z.B. durch Abschneiden der Nachkommastellen 
vornimmt. Unter Umständen reicht es dann aus, 
die Reihenfolge der Komponenten zu verändern, 
um eine korrekte Initialisierung zu gewährlei- 
sten. 


Die typedef-Deklaration 


Bevor ich auf typedef-Deklarationen und Struk- 
turen eingehe, möchte ich in diesem Zusammen- 
hang noch auf einige Mißverständnisse hinwei- 
sen. Zum einen ist das reservierte Wort typedef 
zwar syntaktisch als Speicherzuweisung_ defi- 
niert, reserviert aber zur Laufzeit keinen Platz. 
Damit ist die Bezeichnung eigentlich falsch, dient 
aber einer konsistenten und geeigneten Notation. 

Zweitens und für unsere Betrachtung wichti- 
ger ist, daß durch eine typedef-Deklaration kein 
neuer Variablentyp definiert wird, auch wenn 
dies der Name nahelegt. Mit einer typedef-Dekla- 
ration kann nur ein Name für einen der Grund- 
typen oder einer Untermenge davon neu verge- 
ben werden. Darüber hinaus wird dieser neue 
Name noch in eine Tabelle eingetragen, die die 
einzelnen Bezeichner ordnet, sie befindet sich in 
der Symboltabelle des Compilers (general name 
space). Diese Tabelle umfaßt außerdem die 
Funktionen, die meisten Variablen und Aufzäh- 
lungstypen. Damit unterscheiden sich die durch 
typedef definierten Namen nicht von anderen 
Variablennamen und dienen lediglich zur Klassi- 
fizierung von Bezeichnern, die durch sie festge- 
legt werden. 

Letztlich verwirrt, daß es nicht zulässig ist, 
den Bezeichner einer Speicherklasse im Typ- 
namen der typedef-Deklaration zu benutzen. Der 
Grund dafür liegt darin, daß innerhalb einer De- 
klaration keine zwei Bezeichner von Speicher- 
klassen verwendet werden dürfen. Man könnte 
argumentieren, daß dadurch schwer lesbare Pro- 
gramme vermieden werden, da Speicherattribute 
nicht in der typedef-Deklaration versteckt wären, 
also ein sauberer Programmierstil erzwungen 
wird. Mit anderen Worten: die Attribute einer 
Variablen, die aufgrund einer typedef-Deklara- 
tion definiert werden, könnte man sonst nicht 
klar genug erkennen. Es ist allerdings fraglich, ob 
ein objektorientierter Programmierer dieser Ar- 
gumentation zustimmen kann. 


Speicherbelegung 
von Strukturen 


Es gibt zwei Möglichkeiten, Speicherplatz für 
Strukturen zu reservieren, durch #define und 


typedef. Mit beiden Deklarationen können ähn- 
liche Ergebnisse erzielt werden, sie unterschei- 
den sich allerdings durch syntaktischen Aufbau 
und ganz besonders in ihrer Bedeutung. Zur 
Speicherbelegung sollte im allgemeinen die type- 
def-Deklaration verwenden. Und zwar aus fol- 
gendem Grund: 

Da K&R sich nicht besonders ausführlich über 
den Gebrauch von typedef-Deklarationen ausge- 
lassen haben und die früheren C-Compiler 
(außer von AT&T) diese oftmals nicht unterstützt 
haben (vermutlich aus demselben Grund), igno- 
rierten viele Programmierer bis vor ein paar Jah- 
ren typedef-Deklarationen oder benutzten sie 
falsch. Die gängigste Methode der Deklaration 
war die #define-Direktive. Bevor das reservierte 
Wort void in allen Compilern implementiert war, 
wurde z.B. 


#define void int; 


in das Programm importiert (meist über ein 
eigene Include-Datei wie mydefs.h), ähnlich den 
gebräuchlichen Makros der Datei stdio.h. Ob- 
wohl das im allgemeinen durchaus funktioniert 
(kompilieren Sie doch einfach den Code in 
Listing 8), treten schon bei etwas komplizierteren 
Definitionen Probleme auf, und zwar deshalb, 
weil #define nur als reine Textersetzung zu ver- 
stehen ist, die durch den Präprozessor erledigt 
wird. Nur kümmert der sich nicht im geringsten 
um die Syntax von C. Er ersetzt lediglich einen 
Text durch einen anderen. Solange man ein feh- 
lerfreies C-Programm in den Präprozessor hin- 
eingibt, wird auch ein fehlerfreies Programm her- 
auskommen. Auf der anderen Seite bewertet der 
Compiler typedef- Namen und kann innerhalb 
von Ausdrücken auf Konsistenz der typedef- 
Deklarationen prüfen. 


/* Da void ein Schlüsselwort ist, wird es 
hier nicht benutzt */ 


1 #define v int 


main() 

{ 
int x; 
 .% 


“= y 


vowsaoun2wm 


u 


/* Da void ein Schlüsselwort ist, wird es 
hier nicht benutzt */ 


type int v; 


main() 


int x; 
 ) 


vowson>wm 


Wenn wir uns die wenigen, von K&R geliefer- 
ten Beispiele ansehen, wird deutlich, warum die 
#define-Direktive nicht funktioniert: Zum Bei- 
spiel die Deklaration 


typedef char * String; 


entspricht folgendem #define-Statement: 


#define MAXLINES (5) 
#define String char * 


Ein Beispiel zur Stringverarbeitung: 


String p, 
lineptr [MAXLINES], 
alloc(int); 


Auf den ersten Blick existieren keine Pro- 
bleme. Folgen wir allerdings der Textersetzung 
dieser Zeilen in das, was der C-Compiler erhält, 
so ergibt sich mit: 


char * p, lineptr[5], 
alloc(int); 


sicherlich nicht das beabsichtigte Ergebnis. 

Es wurde nur p als char * deklariert, lineptr als 
ein Array von char und alloc als eine Funktion 
mit einen char-Wert als Ergebnis. Beabsichtigt 
war aber: 


char * p, *lineptr[5], 
*alloc(int); 


Neben dem Problem mit der #define-Direktive 
wird hier übrigens die Gefahr deutlich, in einer 
Deklaration mehrere Deklarationstypen zu ver- 
wenden. Das kann sich als wahrer Fallstrick er- 
weisen! Mehr darüber finden Sie in meinem 
oben erwähnten Artikel. 

Ein anderes Beispiel dafür, daß #define nicht 
immer fuktioniert, ist 


typedef int* array 20[20]; 


Hier gibt es einfach keine Möglichkeit, die 
Deklaration 


array20 samplearray ; 


zu erzeugen. 
Zum Schluß sollten wir noch, um den Bogen 

zu Strukturen und Unions zu schließen, auf die 

Typenprüfung des Compilers eingehen. Sehen 

wir uns das Beispiel Treenode aus K&R an, lautet 

die entsprechende Definition (von Treeptr in die- 

sem Zusammenhang einmal abgesehen): 

#define Treenode struct {\ 

char *word;\ 


int count; \ 


) 
die in der folgenden Form in einem Programm 
verwendet werden könnte: 


Treenode 
Treenode 


tni, tn2; 
tn3, *ptn; 


Trotzdem tn1 und tn2 vom gleichen Typ und 
vollständig kompatibel sind, haben diese Varia- 
blen nichts mit den anderen, die an anderer 
Stelle mit Treenode definiert werden, gemein- 
sam. Auch dann, wenn es sich, wie ptn, um Zei- 
ger handelt. Aus diesem Grund sind die Anwei- 
sungen 


tni = tn2; 
tnl.count = tn2.count; 


korrekt, aber die Anweisungen 


tnl = tn3; 
ptn = Stnl; 


führen zweifellos auf syntaktische Fehler. Um es 
noch deutlicher zu machen, verwenden wir ein- 
mal für jede Definition eine eigene Anweisung: 
Treenode tnl ; 

Treenode tn2 ; 


Treenode tn3 ; 
Treenode *ptn; 


Damit sind die vier Variablen nicht im gering- 
sten miteinander zu kombinieren. Ersetzen wir 
nämlich Treenode durch die entsprechende 
#define-Direktive, wie es der Präprozessor tut, so 
erhalten wir vier voneinander unabhängige, un- 
benannte struct-Deklarationen. Sie sind zwar alle 
zufällig gleich aufgebaut, aber den Compiler 
interessiert das natürlich wenig. 

Wird statt dessen die typedef-Deklaration 
typedef struct | 
char * word; 


int count; 
} Treenode; 


vorgenommen, sind alle oben aufgeführten Zu- 
weisungen zulässig. In der Symboltabelle des 
Compilers wird nun ein einziger Eintrag für Tree- 
node aufgenommen und die anschließende 
Typenprüfung führt nicht mehr auf einen syntak- 
tischen Fehler. Da die typedef-Deklaration echten 
Code darstellt, sind alle durch Treenode definier- 
ten Variablen vom gleichen Typ. 


Aussichten 


Strukturen und Unions sind klar definiert, und 
die meisten Programmierer verwenden sie auch 
einigermaßen erfolgreich. Um sie jedoch in 
ihrem vollen Umfang und vor allem portabel 
nutzen zu können, muß man sich allerdings et- 
was genauer als allgemein üblich mit den Fein- 
heiten auskennen. Das trifft auch für die typedef- 
Deklaration zu, besonders weil sie oft falsch oder 
überhaupt nicht benutzt wird (Typedef-Deklara- 
tionen werden unter OS/2 und in der Umgebung 
des Presentation Managers besonders wichtig). 
Strukturen sind die wichtigsten Hilfsmittel zur 
Konstruktion komplexer Daten in C (und einigen 
anderen Sprachen), und nun, da Sie einiges 
Neues darüber erfahren haben, können Sie die 
Sprache GC ein wenig besser verstehen. Insbeson- 
dere für einen vernünftigen Programmierstil und 
der Entwicklung von portablen Programmen sind 
diese Sprachelemente enorm wichtig. 

Details einer Programmiersprache nicht zu 
kennen ist nie besonders sinnvoll. Es ist zwar 
sicherlich einiges überflüssig oder schlecht um- 
gesetzt, aber ganze Teile des Sprachumfangs von 
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C nicht zu nutzen, nur weil sie ein bißchen an- 
spruchsvoller sind, sollte einem Programmierer 
nicht in den Sinn kommen. Trotzdem C keine 
einfache Sprache ist und zuweilen regelrecht 
kryptisch codiert, führt das Verständnis der fei- 
neren und komplizierteren Strukturen zur Entfal- 
tung der vollen Mächtigkeit von C. 

Nach meinen eigenen Erfahrungen mit C (und 
denen vieler anderer) bringt es wenig, in C zu 
programmieren, wenn man die Sprache nicht 
wirklich verstanden hat. Üblicherweise verlang- 
samt das die Programmentwicklung und verur- 
sacht diverse Fehler, und das kostet Geld. Wenn 
Sie aber am Ball bleiben und sich die Mühe 
machen, die weiterführende Syntax und die da- 
hinterstehende Philosophie zu verstehen, so wird 
Ihnen das Beste, was C zu bieten hat, zur Ver- 
fügung stehen. 

Greg Comeau 


Greg Comeau ist einer der Gründer von Comeau 
Computing, einer unabhängigen Softwarefirma, 
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RAPID Prototyping: 


Hilfe für 
C-Entwickler 


Den Begriff des Rapid Prototyping 
kennt man häufig von RDBMS- 
Entwicklungsumgebungen 
(RDBMS = Relationales Daten- 
bank-Management-System) unter 
DOS und UNIX (z.B. bei Informix, 
RBase) bzw. von deren Sprachen 
der 4. Generation. Solche Spra- 
chen ermöglichen eine nichtproze- 
durale Programmierung. Für den 
Entwickler stellt sich also nicht die 
Frage »Wie löse ich mein 
Problem«, sondern »Was ist mein 
Problem«. Die Lösungsstrategien 
beinhaltet die Sprache selbst, die 
durch ihre Spezialisierung auf 
bestimmte Anwendungsgebiete 
über mächtige, vorgefertigte 
Funktionen verfügen. 


iese Sprachen haben einen bestimmten 

Fokus und sind damit auf spezielle Anwen- 
dungsgebiete beschränkt (z.B. auf Datenbank- 
Anwendungen im kaufmännischen Bereich). Mit 
ihrer Hilfe lassen sich für solche Anwendungen 
schnell Dialogoberflächen aufbauen, Aktionen 
aus fertigen Modulbibliotheken anbinden, Daten- 
bank-Schemata definieren und modifizieren. Der 
Entwickler kann seinem Auftraggeber schnell 
einen Prototypen anbieten und anschließend 
zum fertigen Anwendungssystem weiterent- 
wickeln. 


ECO’s RAPID Prototyping Systen 


RAPID 
> Anwendung konfigurieren 
> Dialog-Oberfläche edieren —’compilieren 
> Dialog-/Aktionsnetz edieren 
> Aktionen programmieren 
>Programmier-Editor 
>Aktion anmelden 


>NAKE-Datei 


>LINK-Datei 
> Anwendung testen 


>Generieren 


>Testen 
> Betriebssysten 


> Ende 


Solche Entwicklungsumgebungen sind äußerst 
nützlich, aber für viele Anwendungsgebiete nicht 
geeignet. Wer mit Sprachen der 3. Generation 
(General Purpose-Sprachen) entwickeln muß 
(z.B. für die Entwicklung technischer Anwen- 
dungen aus dem CAD/CAM-Bereich findet kaum 


Unterstützung durch flexible, leistungsfähige 
RAPID Prototyping-Systeme. Sofern sie über- 
haupt angeboten werden, kann damit zwar ein 
Prototyp erstellt werden — die eigentliche Appli- 
kation muß dann jedoch in einer geeigneten Pro- 
grammiersprache neu geschrieben werden (z.B. 
bei Dan Bricklin's DEMO II). Anders verhält es 
sich bei dem RAPID Prototyping-System, das vom 
ECO Institut entwickelt wurde. 

Das Gesamtpaket des RAPID Prototyping- 
Systems beinhaltet als Hauptkomponenten ein 
User Interface-Toolkit für die Gestaltung von Dia- 
logoberflächen sowie ein User Interface Manage- 
ment-System für die Steuerung der Übergänge 
zwischen Dialog- und Aktionszuständen. 


Die Komponenten des 
RAPID Prototyping-Systems 


Die Oberfläche von »ECO's RAPID Prototyping- 
System« bildet den gesamten Entwicklungszyklus 
einer Applikation ab (Bild 1). RAPID erzwingt ein 
systematisches Vorgehen bei der Entwicklung: Es 


Name der Anwendung: 


VERA 


F18-Anwendungsnam 


Bild 1: 

Abbildung des 
gesamten Entwick- 
lungszyklus einer 
Applikation. 
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muß zunächst ein Systementwurf vorliegen, und 
die Applikation muß etwa in einem Dialog- und 
Aktionsgraphen beschrieben sein. 


infügen DenoListefInitialisieren Hilfe Ende 


ialogzustand Name der Anwendung: 


F1 =Eintrage 
F18-Veruerfer 


>Allgemeine Spezifikationen 


>Gestaltungsobjekte 


vertikale Position (ZN): 
Wr iDas ist ein Beispieltext 
oder Anzahl Leerzeichen: 


Invers |!$5 Aus Blinken Ein WIE 


Bild 2: Anschließend werden die Dialogzustände ge- 
EÜRTREENEDOrN: ZB staltet. Das geschieht objektorientiert mit Hilfe 
und Modifikation 


von Dialogzustän- des speziellen Editors DIALEDIT, d.h. der Desig- 

den. ner der Benutzeroberfläche muß keine bestimm- 
te Spezifikationssprache erlernen. Dialog- 
zustände können unmittelbar getestet und belie- 
big modifiziert werden (Bild 2). DIALEDIT er- 
stellt und ändert automatisch eine Resource- 
Datei, <anwendung>.IPR, die die Beschreibung 
sämtlicher Dialogzustände einer Applikation ent- 
hält. 


‚öschen Einfügen Ersetzen Kopieren Verschieben Suchen Hilfe Ende 


| Deskr iptor 
Maskenfeld 


Obligat. 
Datentyp 
Vorzeichen 
Vert 


Default Kopiere 


Zielzustand 
Zielfeld 


Fortsetzung 


Bild 3: 

Das Dialogverhalten 
kann ohne Kenntnis 
einer Spezifikations- 
sprache beschrieben 


Im nächsten Schritt müssen die Wege zwi- 
schen den Zuständen einer Applikation beschrie- 
ben werden. Zulässige Wege aus einem bzw. in 
einen Zustand sind von Übergangsbedingungen 


Werden: abhängig, also von der Interpretation der 
Benutzerwillensäußerungen oder Aktions-Rück- 
gabewerten und ggf. von dem Ergebnis kontext- 

C freier oder kontextsensitiver Prüfungen von 
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Benutzereingaben. Ebenfalls mit Hilfe eines spe- 
ziellen Werkzeuges, dem Editor RWTEDIT, kann 
dieses Regelwerk schrittweise aufgebaut und 
immer mehr verfeinert werden. Auch bei diesem 
Schritt kann der Designer der Benutzerschnitt- 
stelle ohne jegliche Kenntnis einer Spezifikati- 
onssprache das komplette Dialogverhalten einer 
Applikation beschreiben (Bild 3). Die entspre- 
chenden Ressource-Dateien dieser Regel- und 
Wegetabellen (RWT) werden von RWTEdit auto- 
matisch erstellt und modifiziert. 

Die Dialog- und Aktionsmaschine AUTODIAL 
ist ein vollständig generischer Zustandsautomat, 
der sein Wissen über eine Applikation aus den 
Recource-Dateien erhält. Damit kann ein Proto- 
typ einer Applikation schnell und ohne Program- 
mierkenntnisse aufgebaut und beliebig geändert 
werden, ohne daß hierfür eine Zeile Quellcode 
produziert werden muß. 

Schließlich müssen die Aktionen einer Appli- 
kation programmiert werden, sofern sie anwen- 
dungsspezifisch sind und noch nicht als Modul 
zur Verfügung stehen. Die Aktionen werden suk- 
zessiv als Zustände in die Regel- und Wegetabel- 
le integriert und nach dem Zusammenbinden mit 
der Applikation über AUTODIAL zum entspre- 
chenden Zeitpunkt bzw. unter bestimmten Be- 
dingungen gestartet, die in der Regel- und Wege- 
tabelle definiert sind. Den Zusammenhang der 
verschiedenen Komponenten vom RAPID Proto- 
typing-System zeigt Bild 4. 

Der Prototyp einer Applikation kann ohne 
großen Aufwand solange modifiziert oder er- 
gänzt werden, bis das gewünschte Appli- 
kationsdesign erreicht ist. Die Applikation steht 
damit auch gleichzeitig in endgültiger Form für 
den Realeinsatz zur Verfügung und muß nicht 
mehr — wie bei früheren Prototyping Systemen - 
in einer geeigneten Programmiersprache neu 
programmiert werden. 


Bisherige Erfahrungen 


Derzeit befassen sich verschiedene Firmen z.B. 
auch die Grundig AG oder die Happy User Soft- 
ware GmbH mit dem Einsatz des neuen RAPID 
Prototyping-Systems. Die Grundig-Evaluierungs- 
studie, die gegenwärtig noch bearbeitet wird, soll 
feststellen, ob mit dem Prototyping-System eine 
schnelle Realisierung von Benutzerschnittstellen 
auch unter XENIX möglich ist und ob die Dialog- 
und Aktionsmaschine die Interaktionsverwaltung 
zwischen dem Benutzer und den Modulen leisten 
kann. Man hofft, bei der Entwicklung mit RAPID 
Zeit und Kosten einsparen zu können, indem 
Fehler und Mängel, die bei Verwendung eines 
Pflichtenheftes als wesentliche Entwicklungs- 
grundlage erst relativ spät festgestellt werden 
können, durch Einsatz eines Prototyping-Systems 
bereits frühzeitig erkannt werden. 


t 


Vor allem könnten auch verschiedene Varian- 
ten simuliert und daraus wichtige Gestaltungs- 
hinweise für die Entwicklung gewonnen werden. 
Nicht zuletzt bliebe diese Flexibilität als Resultat 
aus dem Einsatz der Dialog- und Aktionsma- 
schine auch im realisierten Endprodukt erhalten. 

Wünsche und Anforderungen von Endanwen- 
dern ließen sich so relativ einfach und schnell 
berücksichtigen. 


Neue Telefonnummern für 
die Microsoft Hotline 


M: dem Umzug der deutschen Microsoft Nie- 
erlassung nach Unterschleißheim bei 
München konnten die Hotline-Kapazitäten ver- 
dreifacht werden. Erstmals steht auch für den 
Macintosh-Bereich ein eigener Telefonanschluß 
zur Verfügung. Auch die Öffnungszeiten der Hot- 
line wurden verlängert. Die Microsoft Mitarbeiter 
stehen Montag bis Freitag zwischen 9 und 12 
Uhr sowie zwischen 13 und 16 Uhr für telefoni- 
sche Produktinformationen zur Verfügung. 

Mehr als 5000 Anrufe werden jeden Monat 
von den Microsoft Support-Mitarbeitern ent- 
gegengenommen. Hinzu kommen monatlich 
rund 2000 schriftliche Anfragen zu Betriebssyste- 
men, Standardapplikationen und Sprachen. Mit 
der jetzt erreichten Erweiterung der Telefonan- 


Stand der Entwicklung 


Das Gesamtpaket RAPID wird inzwischen für 
MS-DOS im Text- und Grapikmodus und für 
XENIX im Textmodus angeboten. Der Grafik- 
modus unter XENIX auf der Basis von X-Windows 
soll bis Ende 1989 realisiert sein. 

Rainer von Ammon, ECO Institut, Landshuter Str. 
37, 8400 Regensburg 1, Tel.: (0941) 74833 


lage will Microsoft künftig noch mehr Anrufe be- 
wältigen, Wartezeiten verkürzen und damit ihren 
Support für ihre Kunden verbessern. 

Für die verschiedenen Produkte stehen folgen- 
de Durchwahlnummern zur Verfügung: 


Telefonnr. Produkte 


Microsoft Produkte für Macintosh 
Microsoft Multiplan, Microsoft Excel, 
Microsoft Chart, Microsoft Works 
Microsoft Word, Microsoft Windows 
Write, Word Druckertreiber 

Microsoft Flightsimulator, Microsoft 
Windows Utilities, Microsoft Paint- 


089/31705-81 
089/31705-82 


089/31705-83 


089/31705-84 


brush, EasyCad 
089/31705-85 Microsoft Windows/286, Microsoft 
Windows/386, Microsoft Project, 


Microsoft Maus, Netzwerkapplikatio- 
nen, Extended/Expanded Memory, 
LIM Standard 

Microsoft Compiler, Microsoft Quick 
Sprachen 


089/31705-86 


Bild 4: 

Die verschiedenen 
Komponenten des 
RAPID Prototyping- 
Systems. 
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Microsoft C-Kurs für Umsteiger, 
Teil 1: 


Programmie- 
ren in C: Die 
Grundlagen 


Ab dieser Ausgabe des Microsoft 
System Journals bringen wir in 
mehreren Folgen einen C-Kurs für 
Umsteiger, als für Leute, die be- 
reits Erfahrungen mit anderen 
Programmiersprachen wie Pascal 
oder Basic gemacht haben. Der 
Kurs wird die gesamte Palette der 
C-Programmierung zum Inhalt 
haben, von den Grundlagen unter 
QuickC bis zur Anwendungspro- 
grammierung unter Windows. 


0. Einleitung 


Die Programmiersprache C hat sich in den letz- 
ten Jahren zu der am häufigsten verwendeten 
Sprache in der professionellen Software-Entwick- 
lung herausgebildet. Dies ist im wesentlichen auf 
die effiziente Code-Generierung der C-Compiler, 
den standardisierten Sprachumfang und die 
flexiblen Einsatzgebiete von der System- bis zur 
Applikations-Entwicklung zurückzuführen. 
Außerdem gibt es im Umfeld von C eine Reihe 
von leistungsfähigen Werkzeugen und Tool- 
boxen, die die Produktivität der Entwickler stei- 
gern. Für die Betriebssysteme MS-DOS, 05/2 
und SCO XENIX / SCO UNIX ist Microsoft der 
führende Anbieter von C-Compilern. Alle C- 
Compiler von Microsoft unterstützen den vollen 
C-Sprachumfang mit einer Reihe von sogenann- 
ten ANSI-Erweiterungen und erzeugen einen 
optimierten Code. Außerdem beinhalten die Pro- 
dukte eine umfangreiche Runtime-Library, einen 
sehr komfortablen Debugger, mit dem Pro- 
gramm-Tracing auf C-Sourcecode-Level möglich 
ist, und eine ganze Reihe von anderen nützlichen 
Utilities. Dieser C-Kurs soll Ihnen die Program- 
miersprache C näher bringen. Deshalb haben wir 
auch viele Beispiele eingearbeitet. Die Beispiele 
können Sie sofort mit Hilfe von Quick-C auspro- 
bieren. Wir verwenden die Version 2.0 in eng- 
lisch; Ihre Befehlsfolgen können von den hier 
angegebenen abweichen, wenn Sie mit der deut- 
schen Version arbeiten. 


0.1 Die 0 als Mittelpunkt der 
Programmiersprache 

Ein wesentlicher Punkt von C ist, daß alles mit 0 
beginnt oder endet: 


° inC wird immer von O gezählt 

° C benutzt die O für falsch und ungleich O für 
wahr 

« Feldgrenzen beginnen bei 0 

* Strings hören mit dem O-Zeichen auf 

* C-Zeiger benutzen O als Wert für einen nicht 
belegten Zeiger 


C kennt nur Funktionen und wenige soge- 
nannte Schlüsselwörter. Es existieren keine 
Sprachelemente, um Informationen auf dem 
Bildschirm oder der Tastatur aus- bzw. einzu- 
geben (analog INPUT und PRINT in Basic). Dies 
wird nur mit Hilfe von Funktionen realisiert. 
Auch Stringvergleiche sind als Funktionen imple- 
mentiert. 


0.2 Warum C? 

C ist eine kleine Sprache. Sie ist leicht zu erlernen 
(wenige Schlüsselwörter) und gut auf den jewei- 
ligen Prozessor umzusetzen (kompakter Code). 
Durch den Einsatz der richtigen Kontrollstruktu- 
ren und Datentypen können nahezu alle gestell- 
ten Probleme gelöst werden. Durch den Mecha- 
nismus, alles in Funktionen auszulagern, konnte 


der Sprachumfang sehr früh in dem Buch »The 
Programming Language« /1/ von Kerninghan & 
Ritchie dokumentiert werden und wurde so quasi 
normiert. 

C ist portabel. Durch den kleinen Sprachum- 
fang können nicht nur C-Programme, sondern 
auch der C-Compiler selbst schnell portiert wer- 
den. Deshalb werden auch als erstes C-Compiler 
bei neuen Betriebssystemen angeboten (0S/2). 
Die Runtime-Library des Compilers ist ebenfalls 
in C geschrieben. 

C ist prägnant. Durch eine Vielzahl von Opera- 
toren kann der Sourcecode kompakt und knapp 
formuliert werden. Ein einziges C-Statement 
kann in anderen Programmiersprachen unter 
Umständen nur in mehreren Anweisungen pro- 
grammiert werden. Des weiteren sind alle Opera- 
toren auch auf Zeigern definiert, so daß auch mit 
Zeigern gerechnet werden kann. 

C ist modular. Ein C-Programm besteht aus 
einer beliebigen Anzahl von externen Funktio- 
nen, die innerhalb des gesamten Programms auf- 
rufbar sind. C kennt also keine eingebetteten 
Funktionen die Bestanddteil einer anderen Funk- 
tion sind. Jedes C-Programm enthält genau eine 
Main-Funktion (main()). Diese wird nach dem 
Programmstart als erste aufgerufen. Wenn die 
Main-Funktion terminiert, ist das C-Programm 
beendet. 

C ist großzügig. C bietet viele Möglichkeiten, 
die bei einem Mißbrauch zu unübersichtlicher 
Programmstruktur und Laufzeitfehlern führen 
können. Es wird deshalb eine gewisse Disziplin 
vom Entwickler verlangt. So ist C vollkommen 
formatfrei. Eine Anweisung kann eine beliebige 
Anzahl von Blanks, Tabs oder Newlines enthal- 
ten. Die Vielzahl von Operatoren kann bei über- 
triebener Anwendung zu einer unverständlichen 
Programmstruktur führen. Wir empfehlen be- 
sonders dem C-Neuling eine defensive Program- 
mierung. Nicht alles, was in C möglich ist, läßt 
sich mit den Grundsätzen einer klaren und struk- 
turierten Softwareentwickluung vereinbaren. 


0.3 Aufbau des Seminars 

Das Seminar behandelt detailliert den Aufbau 
der Sprache C. Es werden sämtliche Sprachele- 
mente vorgestellt und anhand zahlreicher Bei- 
spiele erläutert. Die Beispiele sind mit dem MSC 
5.1 und dem Quick-C-Compiler 2.0 entwickelt 
und getestet. Jeder Seminarteil ist als eigenstän- 
dige Einheit konzipiert und unterteilt sich in fol- 
gende Kategorien: 

Einleitung: Das Thema des aktuellen Seminarteils 
wird vorgestellt. 

Sprachelemente: Sprachelemente werden vorge- 
stellt und anhand von Beispielen erläutert. Die 
Beispiele sind als Sourcecodefragmente und als 
ablauffähige Programme und Funktionen aufge- 
baut. Sie werden mit Hilfe des Quick C-Compi- 
lers Version 2.0 im Editor erfaßt und ausprobiert. 
Library Guide: Die Beispielprogramme benutzen 


Funktionen der Standardbibliothek. Diese wer- 
den im Rahmen des Library Guide aufgegriffen 
und erläutert. 

Quick-C und MS C-Compiler: Es wird auf Compi- 
leroptionen und Besonderheiten der beiden 
Compiler hingewiesen. 

Utilities: Der MS C-Compiler verfügt über zahl- 
reiche Dienstprogramme, die im Laufe der Serie 
vorgestellt werden. 

Aufgaben: Am Ende eines jeden Seminars werden 
Aufgaben gestellt, die die Möglichkeit bieten, das 
Gelernte zu festigen und zu vertiefen. Dabei wird 
nur auf das vermittelte Wissen der jeweiligen 
Folge zurückgegriffen. Musterlösungen der Auf- 
gaben werden in der nächsten Folge veröffent- 
licht. 

Zusammenfassung und Ausblick: Jeder Seminar- 
teil wird durch eine Zusammenfassung abge- 
schlossen. Es wird ein Ausblick auf die nächste 
Folge des C-Kurses gegeben. 

Der erste Seminarteil befaßt sich mit den 
Grundkonstrukten der Sprache. Dieses Seminar 
geht davon aus, daß der Leser über Grundkennt- 
nisse der Programmierung verfügt und in ande- 
ren Hochsprachen (Fortran, Basic, Pascal etc.) 
schon Software erstellt hat. C steht in dem Ruf 
ebenso schwierig und fehleranfällig wie effizient 
und portabel zu sein. Wir werden sehen, daß C 
vielleicht ein wenig mehr Disziplin erfordert als 
andere Hochsprachen, aber auch enorme Mög- 
lichkeiten bietet. Jedenfalls ist C alles andere als 
schwierig und im Rahmen dieses Kurses pro- 
blemlos zu erlernen. 


main () 

{ 
printf (*\nDas ist mein erstes C-Programm\n*); 
printf ("Es besteht nur aus der main-Funktion\n"); 
printf ("Die Funktion liefert als Funktionswert O\n"); 
printf ("an die rufende Funktion\n"); 


0.4 Das erste C-Programm 

Wir werden das erste C-Programm im Editor der 
Quick-C-Entwicklungsumgebung erfassen. Dazu 
rufen Sie Quick-C im Betriebssystem folgender- 
maßen auf: 


ge 


Geben Sie das in Abb. 1 dargestellte Programm 
ein. Anschließend sichern Sie das Programm 
unter dem Namen ansi.c, indem Sie die Tasten 
Alt-F drücken. Es klappt dann auf der linken 
Bildschirmseite das File-Menu herunter. Sie kön- 
nen dann mit Hilfe der Cursortasten und der 
Return-Taste oder durch Eingabe eines 'a' (= 
Save As) das Dateisicherungsfenster öffnen. 
Geben Sie dann als Dateinamen ansi.c ein und 
drücken Sie die Return-Taste. Damit ist Ihr erstes 
Programm unter dem Namen ansi.c abgespei- 
chert. 

Das Sourcefile ansi.c enhält die Funktion 
main(). Diese Funktion wird beim Programm- 


44 Abb. 1: 
Das erste Programm 
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start als erstes aufgerufen. Sie muß in jedem aus- 
führbaren C-Programm vorhanden sein. Jede 
Funktion besteht aus einem Funktionskopf und 
einem Funktionsrumpf. 

Der Funktionskopf enthält die Namen der 
Parameter der Funktion in runden Klammern (). 
Nach der Aufzählung der Variablen werden die 
Datentypen festgelegt. In unserem Fall werden 
keine Parameter übergeben. 

Der Funktionsrumpf enthält die Variablendefi- 
nition und die Anweisungen der Funktion. Der 
Funktionsrumpf wird immer durch { } ein- 
gerahmt. Am Anfang der Funktionen stehen die 
Variablendeklarationen gefolgt von den Anwei- 
sungen. Funktionswerte werden an die rufende 
Funktion mit Hilfe des Schlüsselwortes return 
übergeben. Wenn kein Funktionsdatentyp ange- 
geben wurde, wird int angenommen. 

In unserem Beispiel erwartet die Funktion 
main() keine Parameter und liefert auch kein Er- 
gebnis. Der Funktionstyp ist void. 


0.5 Übersetzen des ersten Programms 
Bitte übersetzen Sie jetzt das Programm und füh- 
ren Sie es aus. In Quick-C geschieht dies durch 
Drücken der Taste F5. Innerhalb eines Windows 
wird Ihnen dann mitgeteilt, wieviel Zeilen über- 
setzt, wieviele Fehler und Warnungen entdeckt 
wurden. Anschließend wird der Linker aufgeru- 
fen, der aus dem Objektmodul ein ausführbares 
Programm erzeugt. Nachdem das Programm er- 
zeugt wurde, wird es sofort ausgeführt. Sie erhal- 
ten als Ausgabe auf dem Bildschirm: 

Es bestent mar aus dar nalı-Fonktion 


s 
Die Funktion liefert als Funktionswert 0 
an die rufende Funktion 


1. Sprachelemente 


Wir werden uns in dieser Folge mit den grund- 
legenden Sprachelementen beschäftigen. Nach 
den Datentypen, Variablen, Konstanten und 
Zuweisungen wenden wir uns dem Präprozessor 
und den Ein-/Ausgabefunktionen zu. An- 
schließend werden die Operatoren und die Kon- 
trollstrukturen behandelt. 


1.1 Datentypen, Variablen, Konstanten 
und Zuweisungen 

Eine Variablendeklaration in C besteht aus der 
Speicherklasse, dem Datentyp und dem Varia- 
blennamen. Die Deklaration 


int I; 


definiert eine Variable vom Datentyp int 
(Integer). 

Variablennamen können bis zu 31 Zeichen 
lang sein und aus Buchstaben, Ziffern und 
Underscore (_) bestehen. Ziffern dürfen jedoch 
nicht am Anfang stehen. C ist »case sensitiv«, d.h. 
es unterscheidet Groß- und Kleinschreibung. Die 


Bezeichner i und I kennzeichnen also zwei ver- 
schiedene Variablen. 
Lebensdauer und Gültigkeit von Variablen 
C ist eine blockorientierte Programmiersprache. 
Das bedeutet, daß alle zusammenhängenden 
Anweisungen in Blöcken gruppiert werden. 
Blöcke werden durch geschweifte Klammern {} 
eingeschlossen. Im ersten Programm wurden alle 
Anweisungen der Funktion main in einem Block 
(dem Funktionsrumpf) zusammengefaßt. 

Variablen, die innerhalb von Blöcken dekla- 
riert werden, sind nur solange gültig wie auch 
der Block selbst gültig ist. Andere Funktionen 
können also nicht auf die lokalen (=innerhalb 
eines Blocks definierten) Variablen einer Funk- 
tion zugreifen. Neben diesen lokalen Variablen 
gibt es noch globale Variablen, die außerhalb 
einer Funktion definiert werden und von allen 
Funktionen benutzt werden können. 
Die elementaren Datentypen 
char: Ist ein Byte groß und dient zur Speicherung 
ganzzahliger Werte. Der Datentyp char eignet 
sich besonders, um den ASCII-Wert eines Zei- 
chens abzuspeichern (Wertebereich: -127 bis 
127). 
int: Ist ein maschinenabhängiger Datentyp und 
dient zur Speicherung ganzer Zahlen. Ein int ist 
in Abhängigkeit vom verwendeten Prozessor (16- 
Bit 2 Byte, 32-Bit 4 Byte) 2 oder 4 Byte groß 
(Wertebereich 2-Byte-Integer: -32767 bis 32767, 
4-Byte-Integer: -2147483647 bis 2147483647). 
short int: Ist ein kurzer Integer, er ist immer 2 
Byte groß. Statt short int schreibt man kürzer 
short (Wertebereich -32767 bis 32767). 
long int: Ist ein langer Integer, immer 4 Byte. 
Statt long int schreibt man kürzer long 
(Wertebereich -2147483647 bis 2147483647). 
float: Gleitkommazahl mit einfacher Genauigkeit. 
Ist 4 Byte groß. 
double: Gleitkommazahl mit doppelter Genau- 
igkeit. Die Größe beträgt 8 Byte. 

Alle ganzzahligen Datentypen (char, int, short, 
long) können mit dem Attribut unsigned verse- 
hen werden. Ihr Wertebereich ist dann positiv. 


char O0 mr 255 
short 0 65.535 
long O0 4.294.967.395 


Der Datentyp char ist maschinenunabhängig. 
Seine Größe beträgt immer 1 Byte. Der Datentyp 
int ist maschinenabhängig. Selbst die Datentypen 
short oder long sind von der Größe nicht 
genormt. Es ist lediglich festgelegt, daß ein short 
nicht größer sein darf als ein int und ein int nicht 
größer als ein long. Bei allen Compilern, die den 
Autoren bekannt sind, ist ein short 2 Byte und 
ein long 4 Byte lang. 

Komplexe Datentypen 

Aus allen elementaren Datentypen können kom- 
plexere Datentypen (Arrays oder Strukturen) ge- 
bildet werden. So wird ein Feld eines elemen- 


taren Datentyps definiert, indem an den Varia- 
blennamen die Dimension des Feldes in eckigen 
Klammern vermerkt wird: 


char str[10]; 

int 1feld[5]; 

deklariert Felder mit 10 bzw. 5 Elementen. Wie 
eingangs bereits erwähnt, fängt in C alles mit der 
0 an. So ist das erste Element str[0] bzw. 
ifeld[0]. Das letzte Element die str[9] bzw. 
ifeld[4]. Die C-Besonderheit wird von vielen C- 
Anfängern oft vergessen. Da C Feldgrenzen beim 
Zugriff nicht überprüft, können sehr leicht Pro- 
grammfehler entstehen. 

Strukturen werden in einer späteren Folge 
detailliert besprochen. 

Nun aber wieder ran an die Maschine. Das 
nächste Programm wartet. Geben Sie das Pro- 
gramm der Abb. 2 ein, übersetzen Sie es und füh- 
ren Sie es aus. In dem Programm werden Varia- 
blen aller elementaren Datentypen deklariert. 
Der sizeof-Operator wird benutzt, um die Größe 
einer Variablen oder eines Variablentyps in Byte 
zu ermitteln. Bitte beachten Sie, daß nicht eine 
zusammenhängende Zeichenkette angegeben 
wurde, sondern mehrere einzelne. Diese werden 
beim Übersetzen zu einer zusammengefügt. 
Wichtig ist, daß die einzelnen Strings nur durch 
sogenannte »white space characters« (Blanks, 
Tabs, Newlines) getrennt sein dürfen. 


main () 
{ 


char c; 

short s; 

int ıR 

long 1; 

float f; 

double d; 
1 


long double 1d; 


printf (*\n\tGröße elementarer Datentypen in Byte:\n\n* 
"\tchar\t\t%d\n* 
"\tshort\t\t%d\n" 
"\tint\t\t%d\n* 
*\tlong\t\t*d\n* 
"\tfloat\t\t%d\n* 
*\tdouble\t\t%d\n" 
"\tlong double\t%d\n\n", 
sizeof(c), sizeof(s), sizeof(i), 
sizeof (1), sizeof(f), sizeof (d), sizeof (1d)); 
} 


Konstanten 

Die Zuordnung einer Konstanten zu einem 
Datentyp wird über die Deklaration einer Kon- 
stanten realisiert. C kennt folgende Konstanten: 
Ganzahlige numerische Konstanten können im 
Dezimal-, Oktal- oder Hexadezimalsystem ange- 
geben werden. Oktale Konstanten beginnen mit 
einer O (z.B. 0177 entspricht 255), Konstanten 
im Hexadezimalsystem beginnen mit 0x (z.B. 
Oxff entspricht 255). 

Endet die Konstante mit | bzw. L, so wird eine 

long int-Konstante deklariert. Konstanten mit 
dem Suffix U bzw. u haben den Datentyp un- 
signed int. 
Gebrochene numerische Konstanten sind immer 
vom Datentyp double und werden mit dem Dezi- 
malpunkt und/oder in E-Notation angegeben. 
Beispiele: 12.34, 1.234E1, 1234e-2 


Character-Konstanten werden in einfachen Hoch- 
kommata eingeschlossen. 'A' steht für den ASCII- 
Wert 65 (A). Alle Zeichen lassen sich über einen 
Backslash gefolgt von einer oktalen Konstanten 
darstellen: 


'A’ oder ’\081' 
bezeichnen beide den ASCII-Wert des Zeichens 


'A'. Die Sprache C definiert eine Reihe von Cha- 
racter-Konstanten als Escape-Sequenzen: 


\a Alert,Piepton 

\b Backspace 

\f Formfeed 

\n Newline 

\r Carriage Return 

\t Horizontaler Tabsprung 


\v Vertikaler Tabsprung 
\\ Backslash 


\? Fragezeichen 

x Einfaches Hochkomma 
“ Doppeltes Hochkomma 
\nnn Oktalwert (\081) 


Hexadezimalwert (\x1b). 


Stringkonstanten werden in doppelte Anfüh- 
rungszeichen eingeschlossen ("Dies ist eine Zei- 
chenkette"). Stringkonstanten werden im Daten- 
segment abgelegt und mit einem Nullbyte ('\0') 
versehen. Das Nullbyte markiert in C das Ende 
eines Strings. Stringkonstanten können durch 
den Compiler verkettet werden. Insbesondere bei 
langen mehrzeiligen Zeichenketten erhöht diese 
ANSI-Erweiterung die Lesbarkeit eines Pro- 
gramms (s.a. Abb. 2). 

Aufzählungskonstanten (enumerated type) sind 
symbolische Namen, denen ganzzahlige Werte 
zugeordnet werden. Die symbolischen Namen 
erhöhen die Lesbarkeit eines Programms. Es ist 
allerdings nicht definiert, daß Compiler die Gül- 
tigkeit einer symbolischen Zuweisung über- 
prüfen. 

Ändern Sie das Programm aus Abb. 2 so ab, 
daß Sie den einzelnen Variablen nach der Dekla- 
ration Konstanten zuweisen und innerhalb des 
Aufrufs der Funktion printf alle sizeof-Operato- 
ren entfernen. Die Zuweisung in C erfolgt mit 
dem Operator =. Beispiel: 


int i; 


i" 1234; 


1.2 Der Präprozessor 

Der Präprozessor ist ein Textprozessor, der als 
erstes bei einer Compilation aufgerufen wird. Er 
führt Präprozessordirektiven aus, die alle mit 
einem »#« eingeleitet werden. Die wichtigsten 
Direktiven (#define und #include) werden typi- 
scherweise dazu verwendet, Programme über- 
sichtlicher und portabler zu machen, indem 
maschinenabhängige Programmteile in Header- 
files ausgelagert und Konstanten durch symboli- 


44 Abb. 2: 
Größen einzelner 
Datentypen 
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>» Abb. 4b: 
ckurs.h 


>» Abb. 4c: 
ansil.c 


» Abb. 3: 
Programm mit ANSI- 
Escapesequenzen 


>> Abb. 4d: 

ansil.c nach Präpro- 
zessordurchlauf; Die 
Leerzeilen entstehen 
durch Entfernung 
der Kommentare. 


>» Abb. 4a: 
ansi.c 
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sche Namen ersetzt werden. Wir werden die bei- 
den Direktiven #define und #include innerhalb 
dieses Abschnitts anhand von Beispielen erläu- 
tern. 

Die Präprozessordirektive #define 

Wir beginnen hier mit einem durchgängigen Bei- 
spiel, um alle folgende Sprachelemente zu be- 
schreiben. Das Programm wird von Sprachele- 
ment zu Sprachelement erweitert oder verändert, 
damit Sie die Anwendung der Sprachelemente 
direkt anhand eines Programms ausprobieren 
können. 

Wir wollen eine kleine Bildschirmsteuerung 
mit Hilfe der ANSI-Escapesequenzen program- 
mieren. Sehen Sie sich bitte das Programm der 
Abb. 3 an und geben Sie es ein. Sie sehen, daß 
alle Stringkonstanten mit Hilfe der #define-An- 
weisung oberhalb der Funktion main deklariert 
werden. Der Präprozessor ersetzt alle in der 
Funktion enthaltenen Textkonstanten durch die 
nach der Konstanten angegebenen Strings. 


#define ANSI_CLR "\033[2J* 

#define ANSI_INVERS "\033[7m* 

#define ANSI_NORMAL "\033[0m" 

#define ANSI_CURPOS "\033[*u;%uh" 

#define TEXT "Dieser inverse Text beginnt an Zeile/Spalte %d/%d" 


main () 

{ 
printf (ANSI_CLR); 
printf (ANSI_INVERS); 
printf (ANSI_CURPOS, 5, 10); 
printf (TEXT, 5, 10); 
printf (ANSI_NORMAL); 
printf (ANSI_CURPOS, 23, 1); 


Übersetzen Sie das Programm und bringen Sie 
es zur Ausführung. 

Neben diesem reinen Textersatz, ist die Ver- 
wendung von Parametern in #define-Anweisun- 
gen besonders interessant. Dieses sogenannte 
Makro wird genauso aufgerufen wie eine Funk- 
tion. Der Präprozessor ersetzt das Makro mit sei- 
nen Platzhaltern. Dies ist insbesondere dann 
sinnvoll, wenn eine Funktion nur eine Anwei- 
sung hat, da so der durch einen zusätzlichen 
Funktionsaufruf verursachte Laufzeitoverhead 
(Parameterübergabe, Anlegen der lokalen Varia- 
blen) vermieden wird. 

Ändern Sie das Programm der Abb. 3 so ab, 
daß die Cursorposition an das Makro 
ANSI_CURPOS übergeben wird. Dazu müssen 
Sie die printf-Funktion ebenfalls in die #define- 
Anweisung integrieren. In Abb. 4a wurden alle 
Makros mit Parametern versehen. 


#define ANSI_INVERS 7 
#define ANSI_NORMAL 0 
#define ANSI_CLR() printf ("\033[20*) 


#define ANSI_ATTR(a) printf ("\033[%um" ,‚a) 

#define ANSI_CURPOS(z,s) printf (*\033[%u;%uH",z,s) 

#define TEXT(z,s) printf ("Dieser Text beginnt an Zeile/Spalte 
%d/%d",z,s) 


main () 

{ 
/* Bildschirm löschen */ 
ANSI_CLR(); 


/* Attribut invers anschalten */ 
ANSI_ATTR(ANSI_INVERS); 


/* Cursor an Position zeile = 5 und spalte = 10 setzen */ 
ANSI_CURPOS (5,10): 


/* Text ausgeben an zeile = 5 und spalte = 10 */ 
TEXT(5,10); 


/* Cursor an Position zeile = 7 und spalte = 10 setzen */ 
ANSI_CURPOS(7.10); 


/* Attribut normal anschalten */ 
ANSI_ATTR(ANSI_NORMAL) ; 


#define ANSI_INVERS 7 

#define ANSI_NORMAL 0 

#define ANSI_CLR() printf ("\033[29*) 

#define ANSI_ATTR(a) printf ("\033[%um",a) 

#define ANSI_CURPOS(z,s) printf ("\033[%u;%uH*,z,s) 

#define TEXT(z,s) printf ("Dieser Text beginnt an Zeile/Spalte 
%d/%d",z,s) 


#include "ckursi.h* 
main () 


/* Bildschirm löschen */ 
ANSI_CLR(); 


/* Attribut invers anschalten */ 
ANSI_ATTR(ANSI_INVERS); 


/* Cursor an Position zeile = 5 und spalte = 10 setzen */ 
ANSI_CURPOS (5,10); 


/* Text ausgeben an zeile = 5 und spalte = 10 */ 
TEXT(5,10); 


/* Cursor an Position zeile = 7 und spalte = 10 setzen */ 
ANSI_CURPOS(7,10); 


/* Attribut normal anschalten */ 
ANSI_ATTR(ANSI_NORMAL) ; 


main () 
{ 


printf (*\033[29"); 

printf ("\033[%um*,7); 

printf (*\033[&u;%uH",5,10); 

printf ("Dieser Text beginnt an Zeile/Spalte %d/%d",5,10); 
printf (*\033[%u;%uH*,7,10); 


printf ("\033[%&um",0); 


Die Präprozessordirektive #include 

Die #include-Anweisung weist den Präprozessor 
an, die angegebene Datei in den Sourcecode ein- 
zulesen. So können Gruppen von #define-Anwei- 
sungen in Dateien ausgelagert werden, um das 
Programm übersichtlicher zu gestalten. Auch wir 
wollen dies tun. Erfassen Sie ein Headerfile — so 
werden in C die Dateien genannt, die mit Hilfe 
der #include-Anweisung eingelsen werden — mit 
dem Namen ckurs.h, löschen Sie die #define- 
Anweisungen im Programm ansi.c und fügen Sie 
folgende Zeile als erste Zeile des Programms ein: 


#include *ckurs.h* 


Übersetzen Sie das Programm und führen Sie 
es aus. Das Programm aus Abb. 4b zeigt das Hea- 


derfile ckurs.h und die #include-Anweisung. 
Abb. 4d zeigt das Sourcefile, nachdem der Prä- 
prozessor das Headerfile gelesen und die 
#define-Anweisungen ausgeführt hat. 


1.3 printf und getchar 

Da C über keine sprachimmanenten Möglichkei- 
ten verfügt, Informationen auf dem Bildschirm 
auszugeben, gibt es die Funktion printf. Wir 
haben sie in den Beispielen bereits benutzt, ohne 
den genauen Aufbau der Funktion zu erklären. 
An dieser Stelle verweisen wir auf den Abschnitt 
Library Guide, in dem die Funktion printf im De- 
tail erläutert wird. 

Wenden wir uns jetzt getchar zu; getchar ist 
keine Funktion (s.a. Library Guide) sondern ein 
Makro, das in dem Headerfile stdio.h (wird zum 
Compiler mitgeliefert) definiert ist. Wenn Sie das 
Makro benutzen wollen, müssen Sie das Header- 
file mit Hilfe einer #include-Anweisung einbin- 
den. Wir wollen das Programm in Abb. 4 derart 
erweitern, daß nach der Textausgabe das Pro- 
gramm solange wartet bis der Benutzer die Ein- 
gabetaste betätigt. Nach dieser Bestätigung soll 
der Bildschirm wieder gelöscht werden. Ver- 
suchen Sie bitte, das Programm zu schreiben, 
ohne die Abb. 5 anzusehen. Vergleichen Sie an- 
schließend Ihre Version mit dem dort angegebe- 
nen Programm. 


<stdio.h> 
*"ckurs.h* 


#include 
#include 


main () 
{ 


ANSI_CLR(); 
ANSI_ATTR(ANSI_INVERS); 
ANSI_CURPOS (5,10); 
TEXT(5,10); 

getchar(); 


ANSI_ATTR(ANSI_NORMAL); 
ANSI_CLR() ; 


1.4 Operatoren 

C verfügt über eine Vielzahl von Operatoren 
(über 30), die eine kompakte Programmierung 
ermöglichen. Operatoren in C verlangen einen, 
zwei oder drei Operanden. Operanden können 
auch Ausdrücke sein, so daß die Komplexität 
eines Ausdrucks beliebig komplex sein kann. 
Manche Operatoren haben je nach ihrem Kontext 
eine unterschiedliche Bedeutung, da der sicht- 
bare ASCII-Zeichensatz nicht genügend eindeu- 
tige Operatoren zur Verfügung stellt. Wir werden 
an dieser Stelle nicht alle Operatoren behandeln. 
Im ersten Teil des C-Kurses sprechen wir die 
Arithmetik-, Vergleichs-, Zuweisungs- und Inkre- 
mentaloperatoren an. 


1.4.1 Arithmetische Operatoren 

Die arithmetischen Operatoren +, -, *, /, %, 
unterscheiden sich nicht von denen anderer 
Sprachen: 


Addition +: a= 5+3a=8 
Subtraktion - a=5-3a=2 
Division f a=5/3 a=1 
Multiplikation * : a=5*3 a=15 
Modulo % : a= 5%3a= 2 


Interessant sind hier Division und Modulo. Der 
Modulooperator (%) ermittelt den ganzzahligen 
Rest einer Division. Die Division (/) ist auch für 
ganze Zahlen (Datentyp int) definiert. Das Er- 
gebnis ist von dem gleichen Datentyp wie die 
Operatoren. Da 5 und 3 Integerkonstanten sind 
(siehe oben), ist auch das Ergebnis vom Datentyp 
int. 


1.4.2 Zuweisungsoperatoren 

Der Zuweisungsoperator kann mit den arithmeti- 
schen Operatoren verknüpft werden und erspart 
dann die Wiederholung der Variablen innerhalb 
der Zuweisung. Was in anderen Programmier- 
sprachen als 


zaehler= zaehler + 5 


geschrieben werden muß, kann in C viel kürzer 
als 


zaehler + 5; 


codiert werden. Beachten Sie bitte, daß jede An- 
weisung mit einem Semikolon abgeschlossen 
werden muß. 


1.4.3 Inkrement- und Dekrementoperatoren 

Die Inkrement- und Dekrementoperatoren erhö- 
hen (++) bzw. vermindern (--) ihren Operanden 
um eins. Statt 


a. arl 


schreibt man 


ar 


Hier kann der Compiler effizienten Code gene- 
rieren, indem er statt einer Addition eine Inkre- 
mentoperation ausführt. Der Inkrementoperator 
kann auch innerhalb beliebiger Ausdrücke, zum 
Beispiel bei der Indizierung eines Arrays, ver- 
wendet werden. Die Inkrement- und Dekrement- 
operatoren können als Post- und als Pränotation 
verwendet werden. Die Postnotation (a++) be- 
wirkt, daß erst der aktuelle Wert von a im Ge- 
samtausdruck verarbeitet und anschließend a in- 
krementiert wird. Bei der Pränotation (++a) 
wird a erst inkrementiert und dann im Ausdruck 
verwendet: 


1.4.4 Vergleichs- und logische Operatoren 

Die Vergleichsoperatoren (>, >=, <, <=, ==, 
!=) werden für die Programmablaufsteuerung 
benutzt (s.u.). Die Bewertung ergibt 0, wenn die 
Bedingung nicht erfüllt ist, anderenfalls 1. Bei- 
spiel: 
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5<4 0 
6>=-3: 1 
ge=7 : 0 
-10!=3: 1 


Beachten Sie bitte, daß der Gleichheitsopera- 
tor mit zwei Gleichheitszeichen geschrieben 
wird! 

Die logischen Operatoren (&& = AND, || = 
OR, ! = NOT) werden dazu benutzt, Vergleiche 
in Bedingungen zu verbinden: 


am-b 5b arıc 


liefert den Wert 1, wenn a, b und c gleich sind. ! 
(NOT) negiert den Wert einer Anweisung, so daß 


a=-0 und la 


identisch sind. 


1.5 Programmsteuerung (if, for, switch) 
Die Anweisungen für die Programmsteuerung 
dienen dazu, die festgelegte Reihenfolge der 
sequentiellen Abarbeitung der Anweisungen zu 
ändern. 


1.5.1 Die if-Anweisung 
Als erstes ändern wir unser Programm, indem 
wir abfragen, in welche Klasse das erste eingele- 
sene Zeichen in unserem Programm gehört. Dazu 
definieren wir folgende Klassen: 
° Großbuchstaben 
« Kleinbuchstaben 
« Ziffern 
* Sonderzeichen 

Das if-Statement führt die auf die Bedingung 
folgende Anweisung aus, wenn das Ergebnis der 
Bewertung 1 ist, ansonsten wird die Anweisung 
nach dem else ausgeführt. Folgen nach der 
Bedingung mehrere Anweisungen, müssen diese 
innerhalb eines Blocks stehen. Sehen Sie sich als 
Beispiel das Programm der Abb. 6 an. 


#include 
#include 


<stdio.h> 
"ckurs.h" 


main () 
{ 
int c; 


ANSI_CLR(); 
ANSI_ATTR(ANSI_INVERS) ; 
ANSI_CURPOS (5,10); 
TEXT(5,10); 


ANSI_CURPOS(7,10); 
ANSI_ATTR(ANSI_NORMAL) ; 


c= getchar(); 
ANSI_CLR(); 


if (c>='A' B& c<='7') /* Großbuchstabe */ 
printf ("Großbuchstabe\n"); 
else 
if (c>='a' 88 c<='z') /* Kleinbuchstabe */ 
printf (*Kleinbuchstabe\n"); 
else 
if (c>='0' Si c<='9') /* Ziffer */ 
printf ("Ziffer\n"); 
else 
printf (*Sonderzeichen\n"); 


Die Bedingung 
If (ed=ta? Sk c'7t) 


liefert den Wert 1, wenn c (Funktionswert von 
getchar()) zwischen 'A' und 'Z' liegt. Der Aus- 
druck enthält Zeichenkonstanten, Vergleichsope- 
ratoren und logische Operatoren. Ist der Wert 
der Bedingung 0, wird die else-Anweisung ausge- 


1.5.2 Die for-Schleife 
Die for-Schleife in C besteht aus einem Schlei- 
fenkopf und einem Schleifenrumpf. Der Schlei- 
fenkopf enthält das Schlüsselwort for, eine Initia- 
lisierung, einen Kontrollteil und Modifizierung, 
alles durch ; getrennt: 


for (Initialisierung; Bedingung; Modifizierung) 


/* Dies ist der Schleifenrumf */ 


Der Schleifenrumpf muß nur mit {} umschlos- 
sen werden, wenn mehr als eine Anweisung 
folgt. Die Anweisung(en) werden ausgeführt, 
solange die Bedingung einen Wert ungleich 0 lie- 
fert. Vor dem ersten Durchlauf wird die Initiali- 
serung ausgeführt (mehrere Anweisungen wer- 
den durch "," getrennt) und die Bedingung gete- 
stet. Beispiel: 


tor (i= 0; i<10; 1#+) 
printf (*Dies ist Schleifendurchlauf %d \n*, 1); 

Die Schleife wird zehnmal durchlaufen und 
der aktuelle Schleifendurchlauf wird angezeigt. 
Die Bedingung (i<10) gibt an, wie lange die 
Schleife durchlaufen werden soll (solange i klei- 
ner als 10 ist). Der Initialisierungsteil setzt i vor 
dem ersten Durchlauf auf den Wert 1 (i= 1). Der 
Modifikationsteil wird nach jedem Schleifen- 
durchlauf ausgeführt. Er dient in unserem Bei- 
spiel dazu, die Variable i um 1 zu inkrementie- 
ren. 

Ändern Sie bitte unser Programm aus Abb. 6 
so ab, daß der Text fünfmal untereinander aus- 
gegeben wird. 


1.5.3 Die switch-Anweisung 
Die switch-Anweisung erlaubt in C die Program- 
mierung einer Fallabfrage. Für eine Bedingung 
können für verschiedene Fälle unterschiedliche 
Anweisungen ausgeführt werden. In Abb. 7 
wurde das Programm der Abb. 6 dahingehend 
geändert, daß abgefragt wird, ob eine Ziffer zwi- 
schen 1 und 3 eingegeben wurde. Wenn ja, wird 
der um die Anzahl der Zeilen nach unten ver- 
schoben, erneut ausgegeben. Beachten Sie bitte 
die Schlüsselwörter case und break. Ein Fall wird 
mit case, einer Konstanten und dem Doppelpunkt 
: definiert. Er endet mit break. Wird dieses break 
vergessen, wird die nächste Anweisung des fol- 
genden Falls ausgeführt! 

Die default-Anweisung wird ausgeführt, wenn 
keiner der angegeben Fälle zutrifft. 

Sie haben in diesem Abschnitt die wichtigsten 
Operatoren und Kontrollstrukturen kennen- 


gelernt. Sie wissen, wie man in C Konstanten 
definiert und diese in #define-Anweisungen und 
Headerfiles (#include-Anweisung) auslagert. Sie 
haben erfahren, daß C keine Schlüsselwörter für 
die Ein- und Ausgabe bereithält, sondern daß da- 
für die Funktionen printf und getchar verwendet 
werden können. Im folgenden Abschnitt werden 
printf und getchar im Detail behandelt. 


<stdio.h> 
"ckurs.h* 


#include 
#include 


main () 
{ 
int c, i; 


ANSI_CLR(); 
ANSI_ATTR(ANSI_INVERS) ; 
ANSI_CURPOS (5,10); 
TEXT(5,10); 


ANSI_CURPOS (7,10) ; 
ANSIZATTR(ANSI_NORMAL); 


c= getchar(); 
ie 6; 

switch (c) 

{ 


case '1': ANSI_CURPOS(6,10); 


break; 


case '2': ANSI_CURPOS(7,10); 
itt; 
break; 


case '3': ANSI_CURPOS(8,10); 


it= 2; 
break; 


default: printf ("Keine Ziffer zwischen I und 3" 


*eingegeben\n"); 
i= 0; 
break; 
} 


if (i) 
TEXT(1,10); 


2. Library Guide 


Der Library Guide des C-Compilers ist die Be- 
schreibung aller vom Compiler angebotenen 
Funktionen. Wie oben bereits näher ausgeführt, 
bestimmt die mitgelieferte C-Bibliothek die Güte 
des Compilers. Für den MS-C-Compiler werden 
ca. 600 und für den Quick-C Compiler 400 Funk- 
tionen mitgeliefert. Da die Funktionen eines C- 
Compilers nicht genormt sind (ein ANSI-Entwurf 
liegt zwar vor, eine Norm wurde bis dato jedoch 
nicht verabschiedet), kann es bei Portierungen zu 
Problemen kommen, wenn benutzte Funktionen 
in der C-Bibliothek des anderen Compilers nicht 
vorhanden sind. Dies wird innerhalb dieses Kapi- 
tels bei Benutzung von nicht portablen Funktio- 
nen immer gekennzeichnet. So sind beispiels- 
weise sämtliche Grafikfunktionen nur unter MS- 
DOS und OS/2 verfügbar. 

Innerhalb des Library Guides des MS-C-Com- 
pilers 5.1 werden die Funktionen alphabetisch 
aufgeführt. Zu jeder Funktion werden die 
Schnittstelle (inklusive der verwendeten Header- 
files), eine genaue Beschreibung der Funktion, 
die Funktionswerte, Hinweise auf ähnliche Funk- 


tionen und ein Beispiel zur Anwendung der 
Funktion in Form eines C-Programms beschrie- 
ben. 

Der Library Guide des Quick-C Comilers ist 
etwas anders aufgebaut. Dort werden die Funk- 
tionen nicht alphabetisch aufgeführt, sondern in 
Funktionsgruppen unterteilt. Es werden die 
benutzten Headerfiles, die Schnittstelle und die 
Funktionswerte beschrieben. 

In den Beispielen des ersten Seminarteils wur- 
den die Funktionen printf() und getchar() ange- 
sprochen. 


2.1 Die Funktion printf 
Schnittstelle 


#include <stdio.h> 


int printf (format [, argument] ...) 
const char "format; 


Die eigentliche Aufgabe der Funktion printf() 
ist es, einen String auf dem Bildschirm auszu- 
geben. In Abb. 1 wird printf() dazu verwendet, 
Informationen auf dem Bildschirm darzustellen. 

Um auch Werte von anderen Datentypen (int, 
long, float, double) anzeigen zu können, kann 
der String mit Formatangaben belegt werden. 
Formatangaben fangen immer mit dem %-Zei- 
chen an, gefolgt von dem Format selbst. In 
Abb. 2 wurden die Bytelängen (int) der einzel- 
nen Datentypen ausgegeben. Für int-Werte wird 
die Formatangabe %d benutzt. Für jede Format- 
angabe innerhalb des String muß der Funktion 
ein Parameter übergeben werden. Die Funktion 
hat folglich eine variable Anzahl von Parametern 
und zwar immer »Anzahl der Formate des For- 
matstrings plus 1 (der String selber)«. 

Soweit zum einfachen Verständnis der Funk- 
tion. Im folgenden wird der Formatstring syste- 
matisch in seine kombinierbaren Bestandteile 
zerlegt, damit Sie sich einen Überblick über die 
Mächtigkeit der Funktion printf() verschaffen 
können. In der Praxis wird man dann mit einigen 
wenigen Formatangaben auskommen. 

Der Aufbau des Formatstrings 

printf() erhält als ersten Parameter einen For- 
matstring. Der Formatstring besteht, wie oben 
bereits erwähnt, aus normalen Zeichen und den 
Formatangaben. Für jede Formatangabe muß 
eine Variable (durch Komma getrennt) nach dem 
Formatstring angegeben werden. 

Ist die Anzahl der dem Formatstring folgenden 
Parameter ungleich der Anzahl der Formatanga- 
ben in dem Formatstring, so werden entweder 
weniger Variablen formatiert (Anzahl der Para- 
meter größer) oder es kommt zu undefinierten 
Ausgaben (Anzahl der Parameter kleiner). 

Der Formatstring wird wie folgt zerlegt: 


% [Ausrichtung] [Breite] [.Genauigkett) [FIN|hil|L] Typ 


Den einzelnen Teilen des Formatstrings kann 
jeweils ein Wert aus den folgenden Tabellen 
zugeordnet werden. Die Teile in den eckigen 
Klammern sind optional anzugeben. 
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Typ 

Als erstes werden die verschiedenen Typen defi- 
niert, da in der weiteren Erläuterung immer wie- 
der Bezug darauf genommen wird. 


Typ Datentyp Ausgabe 


d,i int numerisch mit Vorzeichen 
(-32.767 .. +32.767) 

u int numerisch ohne Vorzeichen 
(0 .. 65535) 

0 int oktal (0 .. 177777) 

X int hexadezimal (benutzt 
»abcdef«, O .. ffff) 

X int hexadezimal (benutzt 
»"ABCDEF«, 0 .. FFFF) 

f double gebrochener Wert der Form 
[-Jdddd.dddd 

e double Exponentialdarstellung der 
Form [-]d.dddd e [-/+]ddd 

E double wie e, jedoch wird ealsE 
ausgegeben 

g double wird ausgegeben wie f oder 
e, je nachdem welche Aus- 
gabe kürzer ist 

G double wie g, jedoch bei E-Forma- 
tierung Ausgabe mit E 

c char ein einzelnes Zeichen 

s char * Ausgabe eines Strings vom 
übergebenen Pointer bis zur 
Stringendekennung ('\0') 

p Zeiger gibt die Adresse des Zeigers 
in der Form xxxx.yyyy aus, 
wobei xxxx das Segment 
und yyyy der Offset inner- 
halb des Segmentes ist 

% - Ausgabe des Prozentzei- 
chens 

Ausrichtung 

Zchn Bedeutung Vorbelegung, 

wenn nicht 
gesetzt 
- linksbündig inner-- rechtsbündig 
halb der gesetzten 
Feldbreite 

+ Ausgabe eines kein Pluszeichen 
Pluszeichens 
vor der Zahl 

u Ausgabe eines kein Leerzeichen 
Leerzeichens 
vor der Zahl 

# bei Verwendung jedem Wert un- 
mit Typ 0,x gleich 0 wird ein 0, 
oder X: 0x oder 0X 
keine Ausgabe vorangestellt 
bei Verwendung 
mit Typ e, E, f: 
Ausgabe des Dezi-_ die Ausgabe enthält 
malpunktes nur immer einen 
wenn Nach- Dezimalpunkt 


Zchn Bedeutung Vorbelegung, 
wenn nicht 
gesetzt 

kommastellen 

vorhanden sind 

bei Verwendung 

mit Typ g oder G: 

wie oben; Nullen 

wie bei Typ e, nach dem Dezimal- 


E oder f, jedoch 
werden hier auch 

die Nullen nach dem 
Dezimalpunkt nicht 
abgschnitten 

Bei den Typen c, d, 

i, u oder s wird 
dieses Formatzeichen 
ignoriert 


punkt werden 
abgeschnitten 


Breite und Genauigkeit 

Die Breite gibt die minimale Anzahl von Zeichen 
an, die ausgegeben werden sollen. Wenn die 
Ausgabe kleiner ist als die Breite, so werden - in 
Abhängigkeit von der Ausrichtung — links oder 
rechts Leerzeichen eingefügt. Beginnt die Brei- 
tenangabe mit einer 0, so werden anstatt der 
Blanks Nullen eingefügt. 

Die Breite ist also nicht die absolute Breite der 
Ausgabe, sondern die Anzahl der Zeichen, die 
mindestens ausgegeben werden sollen. Die Aus- 
gabe wird nie abgeschnitten. 

Daneben existiert eine Ausnahme. Die Breite 
kann auch ein Stern * sein. In diesem Fall wird 
der korrespondierende int-Wert der Parameter- 
liste als Feldbreite herangezogen. 

Die Genauigkeit ist abhängig von dem ver- 
wendeten Typ. 


main () 

{ 
int i; 
int breite; 
int genau; 
i= 12345; 


breite= 10; 

genau= 7; 

printf (*<%d>\n*, i); 

printf ("<$-d>\n", 1); 

printf ("<$10d>\n", i); 

printf ("<s-10d>\n", i); 

printf ("<&010d>\n", i); 

printf ("<-010d>\n", i); 
printf ("<$10.6d>\n", i); 
printf ("<$-10.6d>\n", 1); 
printf ("<$*.6d>\n", breite, i); 
printf ("&-*.*d>\n", breite, genau, i); 


Geben Sie das Programm der Abb. 8 ein und 
sehen Sie sich die Ergebnisse an. Bei diesem Pro- 
gramm wurde bereits mit der Genauigkeit gear- 
beitet. Diese gibt bei den Typen d, i, u, 0, x, und 
X an, wieviel Ziffern mit führenden Nullen inner- 
halb der Breite ausgegeben werden sollen. 

Die Genauigkeitsangabe in Verbindung mit 
den Typen e, E und f bestimmt die Anzahl der 
Nachkommastellen, wobei die letzte dargestellte 


Ziffer gerundet wird. Hier wird als Vorbelegung 
eine 0 gesetzt. Die Typen g und G interpretieren 
die Genauigkeit als maximale Anzahl signifikan- 
ter Ziffern. Wird nichts angegeben, werden alle 
Ziffern ausgegeben. 

Für Strings (Typ s) bestimmt die Genauigkeit 
die maximale Anzahl der Zeichen, die ausgege- 
ben werden sollen. Ansonsten wird bis zum 
nächsten Stringendekennzeichen ('\0') ausgege- 
ben. Ändern Sie das Programm der Abb. 8 dahin- 
gehend ab, daß Sie sich einen String 


#define TEXT "Text für die Formatierung mit printf" 


definieren und die Variable i durch TEXT 

sowie %d durch %s ersetzen. 

FRN,hLL 

Diese Angaben innerhalb des Formatstrings 
ändern den erwarteten Datentyp der Parameter- 
leiste. 

F und N ändern die Pointerart. F bestimmt 
einen far Pointer und N einen near Pointer. Diese 
Formatierungsart ist nicht kompatibel zum ANSI- 
Standard. 

Der Prefix h wird dazu benutzt, der Formatie- 
rungsroutine mitzuteilen, daß für die Typen d, i, 
0,x und X der Parameter nicht vom Datentyp int, 
sondern vom Datentyp short int ist. Gleiches gilt 
für u (unsigned short int). 

l ändert die Parameter der Typen d, i, 0,x und 
X von int auf long int. Für den Typ u wird mit lu 
ein Parameter vom Datentyp unsigned long int 
erwartet. 

L kann nur im Zusammenhang mit den Typen 
e, E, f, g und G benutzt werden. Es wird dann 
anstatt eines double- ein long double-Parameter 
erwartet. 

Die Funktion printf() wird auf den Seiten 
456ff. der Run-Time Library Reference beim 
Microsoft 5.1 Compiler und auf der Seite 328 
beim Quick-C Compiler 2.0 beschrieben. 
Funktionswert 
Die Funktion liefert die Anzahl der ausgegebenen 
Zeichen. 

Verwandte Funktionen 

sprintf: sprintf stellt das Ergebnis nicht auf dem 
Bildschirm dar, sondern in einem Buffer, der der 
Funktion übergeben wird: 


int sprintf (buffer, format [, argument] ...) 
r *buffer; 


const char *format; 


Dabei ist zu beachten, daß der Datenbereich, 
auf den buffer zeigt, groß genug sein muß, um 
alle Zeichen, die sprintf erzeugt, aufnehmen zu 
können. 
fprintf: Bei fprintf wird das Ergebnis in eine Datei 
geschrieben. Die Dateioperationen werden in 
einem weiteren Teil des C-Kurses behandelt. 
vprintf, vsprintf, vfprintf: Der Unterschied zu den 
Funktionen printf, sprintf und fprintf besteht 
darin, daß die Funktionen anstatt der Para- 
meterliste einen Pointer auf eine Liste von Argu- 
menten übergeben bekommen. Diese Funktionen 


sind hier nur der Vollständigkeit halber aufge- 
führt; mit Ihrem bisherigen Wissen über C kann 
noch nicht mit diesen Funktionen gearbeitet 
werden. Wir verweisen daher auf eine spätere 
Folge dieses Seminars. 

scanf: scanf() ist das Analogon zu printf(). Wäh- 
rend printf() auf dem Bildschirm formatiert, liest 
scanf() von der Tastatur Zeichen ein. Diese Zei- 
chen werden auf die Parameterliste übertragen. 
Da Sie hierzu wissen müssen, wie Sie mit Zeigern 
auf Variablen arbeiten, wird nicht an dieser 
Stelle, sondern erst im Kapitel über Zeiger ein 
Beispiel folgen. 


2.2 Die Funktion getchar 
Schnittstelle 


int getchar() 


Die Funktion wird dazu benutzt, ein Zeichen 
von der Tastatur einzulesen und dies als Funkti- 
onwert an die aufrufende Funktion zu über- 
geben, wie dies in Abb. 6 und Abb. 7 gemacht 
wird. 

getchar() ist eigentlich keine Funktion. 
getchar() wird in dem Headerfile stdio.h mit 
Hilfe folgender Präprozessoranweisung umge- 
setzt: 


#define getchar() getc(stdin) 


Getc() selbst ist auch ein Makro (so nennt man 
auch Umsetzungen des Präprozessors, die quasi 
als Funktionen benutzt werden). Die Umsetzung 
hier anzuführen, würde im Moment nur verwir- 
ren; deshalb wird hier nur die Funktionsweise 
beschrieben. 

Stdin ist ein Filepointer (Dateizeiger), in den 
Dateiinformationen geschrieben werden. Ein 
Filepointer wird beim Öffnen der Datei erzeugt. 
Er zeigt auf eine Datenstruktur, die Informatio- 
nen über die Datei enthält (Zeiger auf nächstes 
Zeichen der Datei, Open-Flags: readonly, write- 
only, read/write, Dateinummer des Betriebs- 
systems, etc.). Auch der Bildschirm wird in C wie 
eine Datei behandelt. Beim Starten des Pro- 
gramms werden — noch bevor die main()-Funk- 
tion aufgerufen wird — folgende Dateien geöff- 
net: 


stdin Standard Input 
stdout Standard Output 
stderr Standard Error 
stdaux Standard Auxilary 
stdprn Standard Printer 


Als C-Programmierer können Sie, ohne vorher 
eine Datei geöffnet zu haben, von der Tastatur 
Zeichen einlesen (stdin) und auf dem Bildschirm 
Informationen ausgeben (stdout). Die Buffer 
stdaux und stdprn werden nur vom Microsoft C- 
Compiler geöffnet. Andere C-Compiler-Imple- 
mentierungen verwenden nur die ersten drei 
Buffer. 


C-Kurs 


Microsoft 
System Journal 


Sept./Okt. 1989 


153 


» Abb. 9: 
Beispiel mit getch 


» Abb. 10: 
Umwandlung von 
eingegebenen Zei- 
chen; Bitte beachten 
Sie die Zeile ch-= 'A' 
- 'a'. In C können Sie 
den Abstand zwi- 
schen den Groß- und 
Kleinbuchstaben 
durch die Differenz 
'A' - 'a’ bestimmen. 
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Wie der Buffer aufgebaut ist, erfahren Sie in 
einem der nächsten Seminarteile. 

Die Funktion überträgt die Zeichen erst, wenn 
ein Zeilenendekennzeichen eingegeben wurde. 
Unter MS-DOS ist dies die Returntaste ('\r'). 
Verwandte Funktionen 
fgetc, fgetchar: Diese Funktionen arbeiten auf 
Dateien. Es wird das nächste Zeichen von einer 
Datei eingelesen. Sie haben die gleiche Funktio- 
nanlität wie getc() und getchar(). 
getch, getche: Diese Funktionen übergeben das 
Zeichen sofort nach dem es eingegeben wurde. 
Die Funktion getch() übergibt das Zeichen nur 
an das Programm, getche() (e=echo) läßt es zu- 
sätzlich auf dem Bildschirm erscheinen. 
putc, putchar: putc() und putchar() schreiben ein 
Zeichen auf den spezifizierten Buffer (s.o.). Da- 
mit können Zeichen an der aktuellen Position auf 
dem Bildschirm ausgegeben werden. Abb. 9 ent- 
hält ein Programmbeispiel, das alle Zeichen von 
der Tastatur einliest und anschließend nur die 
Buchstaben zwischen A und M auf dem Bild- 
schirm ausgibt. Die Schleife wird beendet, wenn 
ein X eingegeben wird oder ein Fehler beim Ein- 
lesen der Zeichen aufgetreten ist. 


#include <stdio.h> 
#include <conio.h> 


main () 
{ 
char ch; 
while ( ( ch= getch() ) != EOF) 


if (ch>='A' && ch<='M') 
putchar (ch); 


if (ch=='xX') 
break; 


Beachten Sie bitte dabei, daß die Funktion 
getch() verwendet wird, die das eingegebene 
Zeichen nicht auf dem Bildschirm darstellt. 


#include <stdio.h> 


main () 
{ 
char ch; 
while ( ( ch= getchar() ) != EOF) 


if (cho=’A' && ch<='M') 
putchar (ch); 


if (ch>='a' A& ch<='m') 
l 
ch-= 'a' - 'A'; 
ungetc(ch, stdin); 
} 


if (che='X') 
break; 


ungetc: Die Funktion ungetc() wird dazu benutzt, 
um bereits eingelesene Zeichen wieder in den 
Dateibuffer zu stellen. Sie wird in Abb. 10 in Er- 
gänzung zum Beispiel in Abb. 9 dazu verwendet, 
alle Kleinbuchstaben in Großbuchstaben umzu- 
wandeln (beachten Sie bitte, daß in dieser Funk- 


tion mit getchar() die Zeichen eingelesen wer- 
den!). 

Sie haben nun die Funktionen printf() und 
getchar() kennengelernt. Das nächste Kapitel be- 
schäftigt sich dem MS C-Compiler Version 5.1. 
Dort werden wichtige Optionen besprochen und 
die Arbeitsweise des Compilers erklärt. 


3. Quick-C und MS C- 
Compiler 5.1 


Nachdem in den Beispielen die Entwicklungsum- 
gebung Quick-C zur Eingabe und Übersetzung 
verwendet wurde, wird in diesem Kapitel erläu- 
tert, wie mit dem MS C-Compiler Version 5.1 ge- 
arbeitet wird. 


3.1 Arbeitsweise 

Der MS C-Compiler übersetzt ein im Editor er- 
stelltes C-Programm in ein Objektmodul bzw. er- 
stellt ein ausführbares Programm (s. Optionen 
innerhalb dieses Kapitels). Die Übersetzung läuft 
in drei verschiedenen Phasen ab: 

Präprozessor: Der Präprozessor liest alle ange- 
gebenen Headerfiles ein und ersetzt die #defines 
und Makros durch die definierten Werte. Sie 
können sich eine solche Datei erzeugen lassen, 
wenn Sie die Option /P verwenden. Die vom 
Präprozessor erzeugte Ausgabe wird in die Datei 
fn.i gestellt, wenn fn.c der Name des C-Pro- 
gramms ist. 

Syntaxchecker: Der Syntaxchecker bekommt als 
Eingabe die vom Präprozessor erstellte Datei. Die 
Art der Syntaxüberprüfung kann mit der /W- 
Option angegeben werden (s.u.). 
Codegenerierung: Die syntaktisch richtige Datei 
wird dann dem Codegenerierungsmodul über- 
geben. Auch hier können Sie die Art der Code- 
generierung beeinflussen. Alle Optionen, die mit 
/G beginnen, werden dazu verwendet be- 
stimmten Maschinencode zu erzeugen (8086, 
80286, etc.). Optionen, die mit /O anfangen, ver- 
ändern den Code in Hinsicht auf Optimierungen 
(/Os für size = Größe, /Ot für time = zeit). Alle 
mit /A anfangenden Optionen bestimmen das 
verwendete Speichermodell und damit ebenfalls 
die Codegenerierung. 

Die in diesem Seminarteil angegebenen Bei- 
spiele können auch mit dem MS C-Compiler Ver- 
sion 5.1 übersetzt werden. Der Aufruf des Com- 
pilers erfolgt mit: 
ce] beispiel.c 

Dieser Befehl übersetzt das Programm bei- 
spiel.c und erstellt das ausführbare Programm 
beispiel.exe. Wenn Sie lediglich ein Objektmodul 
erzeugen wollen, müssen Sie die Option /c hin- 
zufügen: 


ce /c beispiel.c 


Die beiden anderen Optionen /AM sowie /W3 


werden in den folgenden beiden Abschnitten 
»Speichermodell«e und »Warnungsstufe« erläu- 
tert. 

Mit dem Aufruf 


el /HELP 


werden auf dem Bildschirm alle möglichen 
Optionen und eine Kurzhilfe zu jeder Option 
ausgegeben. 


3.2 Speichermodelle 

Aufgrund der Adressierungsart des 80x86-Pro- 
zessors (Segment und Offset) gibt es mehrere 
Möglichkeiten, Objektcode zu generieren. Je 
nachdem, ob das Segment konstant oder variabel 
ist, können maximal 64 Kbyte oder mehr ange- 
sprochen werden. Diese Besonderheit des Pro- 
zessors nennt man auch Speichermodell. Weil für 
die Codegenerierung jeweils zwei Segmente 
verwendet werden (Daten- und Codesegment), 
kann der MS C-Compiler für insgesamt vier (2 
mal 2) verschiedene Speichermodelle Objektcode 
erzeugen. Die Speichermodelle werden mit der 
/A-Option — gefolgt von dem Speichermodell — 
angegeben: 


/AS (Small Memory Model, Default-Einstellung) 
/AM (Medium Memory Model) 

/AC (Compact Memory Model) 

/AL (Large Memory Model) 


Die Speichermodelle unterscheiden sich hin- 
sichtlich der Größe des Datenbereichs und der 
Größe des Programmcodes. In der folgenden 
Übersicht werden für jedes Speichermodell die 
Segmentdefinitionen angegeben: 

/AS: Datenbereich und Programmcode können je 
64 Kbyte nicht überschreiten (Daten- und Code- 
segment konstant). 

/AM: Der Datenbereich ist maximal 64 Kbyte 
groß und der Programmcode kann theoretisch 
beliebig (MS-DOS Grenze 640 Kbyte) groß sein 
(Datensegment konstant und Codesegment varia- 
bel). 

/AC: Datenbereich ist beliebig (MS-DOS Grenze 
640 Kbyte) groß und der Programmcode kann 64 
Kbyte nicht überschreiten. 

/AL: Der Datenbereich und der Programmcode 
können beliebig (MS-DOS Grenze 640 Kbyte) 
groß werden, jedoch sind einzelne Variblen auf 
64 Kbyte begrenzt. 

Neben diesen vier Speichermodellen existiert 
noch das Huge-Speichermodell (Option /AH). Es 
entspricht dem des Large-Modells, nur daß auch 
einzelne Datenelemente (beispielsweise Felder) 
größer als 64 Kbyte werden können. 

Die Art des Speichermodells hat auch Auswir- 
kungen auf die Geschwindigkeit des Programms. 
Bei konstanten Segmenten muß das Segment- 
register, das zur Adressierung von Programm- 
code und Datenbereich herangezogen wird, nur 
bei Programmstart geladen werden (Small- 


Modell). Sind die Segmente variabel (Large- 
Modell), so müssen für jede Funktion und für 
jede Variable die entsprechenden Segmentregi- 
ster geladen werden. 


3.3 Warnungen 
Der MS C-Compiler bietet insgesamt vier War- 
nungsstufen an. Diese können mit der Option /W 
und Angabe der Warnungsstufe eingeschaltet 
werden. Warnungen dienen dazu, die Syntax zu 
überprüfen und bei Funktionsaufrufen die aktu- 
ellen mit den formalen Parametern zu prüfen. 
Die formalen Parameter können in sogenannten 
Funktionsprototypen auch für Funktionen defi- 
niert werden, die sich nicht im aktuell übersetz- 
ten Sourcecode befinden. Die aktuellen Parame- 
ter werden beim Aufruf der Funktion mit den 
formalen verglichen. Abweichungen werden in 
Form von Fehlermeldungen dokumentiert. Im 
Anhang E (Error Messages) des User's Guide 
werden alle Fehler, die der Compiler beim Über- 
setzen meldet, aufgeführt. Warnungen beginnen 
mit C4. Sie enthalten neben dem Text auch einen 
Hinweis, ab welcher Warnungsstufe dieser Feh- 
lertext ausgegeben wird. In dieser Folge wird mit 
der Warnungsstufe 1 gearbeitet, da für die Ar- 
beitsweise der Warnungsstufen 2 und 3 ein 
detailliertes Verständnis von Funktionsproto- 
typen erforderlich ist, die erst in der nächsten 
Folge besprochen werden. 
/WO oder /w: mit diesen beiden Optionen wer- 
den alle Warnungen unterdrückt. 
/W1 ist die Voreinstellung, wenn keine /W-Op- 
tion angegeben wird. Innerhalb dieser War- 
nungsstufe werden fast alle Warnungen ausge- 
geben. 

/W2 überprüft zusätzlich, ob 
° für aufgerufene Funktionen deren Funktions- 
werte angegegeben worden sind, 
* innerhalb einer Funktion, die nicht den Daten- 
typ void hat, eine return-Anweisung steht, 
® bei Zuweisungen zwischen verschiedenen 
Datentypen Informationen verlorengehen kön- 
nen. Das in Abb. 11 angegebene Programmbei- 
spiel erzeugt beim Übersetzen eine eine War- 
nung, daß bei der Zuweisung Informationen ver- 
lorengehen. 


main () 
{ 


char ch; 
int i; 


/W3 überprüft bei Funktionsaufrufen die aktu- 
ellen mit den formalen Parametern (Funktions- 
prototypen). Diese Überprüfung gehört nicht 
zum C-Compiler nach /1/. Sie wurde von Micro- 
soft implementiert, damit ein häufiger Fehler bei 
C-Programmen (nicht korrekte Versorgung der 


44 Abb. 11: 
Warnungsstufe 2; 
Compilerausgabe: 
test.c(8): C4051 
data conversion 
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Funktionen mit Parameter) vom Compiler über- 
prüft werden kann. Funktionsprototypen müssen 
vor dem ersten Aufruf der Funktion definiert 
werden. Die Formalparameterdefinition wird bei 
jedem Aufruf der Funktion innerhalb des Pro- 
gramms mit den aktuell übergebenen Parame- 
tern verglichen. Wird eine Abweichung festge- 
stellt, gibt der Compiler eine entsprechende Mel- 
dung aus. Funktionsprototypen werden in der 
nächsten Folge detailliert besprochen. 


4. Aufgaben 


Im folgenden werden Übungsaufgaben gestellt, 
die anhand des behandelten Sprachumfangs 
implementiert werden können. Die Musterlösun- 
gen werden in der nächsten Folge veröffentlicht. 


4.1 Rahmenprogramm 

Erstellen Sie ein Programm, das einen einfachen 
oder doppelten Rahmen zeichnet. Sie können mit 
Hilfe der Zeichenkonstanten ("\nnn') die Block- 
grafik des IBM-Zeichensatzes benutzen. 


4.2 Mehrfachselektion (check box) 
Schreiben Sie ein Programm, daß folgende Texte 
auf dem Bildschirm ausgibt: 


Beantworten Sie bitte folgende Fragen: 


In der Programiersprache C 


jede Anweisung mit einem Semikolon 
gie. A SE aStenereT, für Ein- und Ausgabe 
nnen Felde: 
I NET aeirissenibe Pa 
sind die Anweisungen a=a+3 und a+=3 identisch 


aerasne Auswahl 
= nächstes Feld 
Ehniake = alle Fragen beantwortet 


Der Benutzer soll die gestellten Fragen beant- 

worten. Dazu wird der Cursor beim Programm- 
start auf die Position zwischen die ersten beiden 
eckigen Klammern gestellt. Der Benutzer hat 
dann die Möglichkeit, durch Eingabe der Leer- 
taste die Frage anzukreuzen. Es erscheint ein 'X'. 
Um zu der nächsten Frage zu gelangen, muß er 
die Tab-Taste drücken. Wird in einem angekreuz- 
ten Feld die Leertaste gedrückt, soll das 'X' durch 
ein Leerzeichen ersetzt werden. Wenn der Benut- 
zer mit der Benatwortung der Fragen fertig ist, 
gibt er die Eingabetaste ein. Danach soll die Mel- 
dung erscheinen, ob der Benutzer die Fragen 
richtig beantwortet hat. 
Hinweis: Um die Aufgabe übersichtlich zu lösen, 
sollte ein Feld aus int-Werten definiert werden, 
in dem vermerkt wird, ob eine Möglichkeit an- 
oder ausgeschaltet ist. Verwenden Sie die im Ab- 
schnitt Library Guide angesprochene Funktion 
getch zum Einlesen von Zeichen. Benutzen Sie 
zur Positionierung die im Abschnitt Sprachele- 
mente definierten ANSI-Sequenzen. 


4.3 Einfachselektion (radio buttons) 
Andern Sie das Programm der Aufgabe 4.2 so, 
daß nur noch eine Antwort wählbar ist. Ersetzen 


Sie die eckigen durch runde Klammern und be- 
nutzen Sie als Markierungszeichen den ASCII- 
Wert '\371' (oktal). 

Wenn der Benutzer eine Antwort ankreuzt, 
soll automatisch eine zuvor gewählte Alternative 
gelöscht werden. 


4.4 Dialogbox 


Kombieren Sie die drei zuvor gelösten Aufgaben 
zu einer Dialogbox. Eine Dialogbox hat eine 
doppelte Umrandung. Die Überschriften werden 
durch eine einfache Linie von den Selektionsfel- 
dern getrennt. 


5. Zusammenfassung und 
Ausblick 


In dieser Folge haben wir wesentliche Grund- 
elemente der Sprache C kennengelernt und an 
Beispielen zur Ein-/Ausgabe demonstriert. 

Ein C-Programm besteht aus einer beliebigen 
Anzahl von Funktionen, von denen mindestens 
eine Funktion main heißen muß, die den Pro- 
grammstart markiert. C kennt die elementaren 
Datentypen char, int, short, long, float und dou- 
ble. Konstanten haben in C immer eine Typbin- 
dung. Wir haben String-, Character-, Aufzäh- 
lungs- und Integerkonstanten besprochen. Ein 
wesentlicher Bestandteil der Sprache C ist der 
Präprozessor. Er führt Textersetzungen vor der 
eigentlichen Übersetzung durch. Wir haben die 
Präprozessoranweisungen #define und #include 
kennengelernt. 

In der nächsten Folge werden wir uns mit den 
restlichen Operatoren (Bit- und Boolschen Ope- 
ratoren) auseinandersetzen. Es wird ein Taschen- 
rechner entwickelt, der neben den gängigen 
mathematischen Operationen auch Umrechnun- 
gen zwischen verschiedenen Zahlensystemen be- 
herrscht. Um die Daten einzugeben, entwickeln 
wir eine Funktion zur kontrollierten und typ- 
genauen Dateneingabe. Wir besprechen die Defi- 
nition von Funktionen und die Handhabung von 
Prototypen und erläutern den Aufbau eines C- 
Programms aus mehreren Sourcefiles sowie die 
Handhabung des Linkers. 

Innerhalb des Kapitels Library Guide haben Sie 
die Funktionen bzw. Makros printfl) und 
getchar() sowie deren verwandte Funktionen 
kennengelernt. Anhand einiger Beispiele wurde 
die Anwendung verdeutlicht. Im nächten Teil er- 
fahren Sie mehr über String- und Datentypum- 
wandlungsfunktionen. 

Im Kapitel über den MS C-Compiler wurde die 
Arbeitsweise (Präprozessor, Syntaxüberprüfung, 
Codegenerierung) erläutert und wichtige Optio- 
nen erklärt. Der nächste Teil beschäftigt sich mit 
dem Environment des Compilers und beschreibt 
die getrennte Compilierung von C-Programmen. 
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Word 5.0 jetzt für MS-DOS und 
MS 05/2: 


Dieses ist 
der fünfte 


Streich ... 


... und der sechste, der kann ruhig 
noch ein wenig warten, denn mit 
der Version 5.0 - die ab September 
im Handel ist - hat Word wieder 
einen mächtigen Sprung nach vorn 
gemacht. Microsoft unterstreicht 
damit ihren Führungsanspruch in 
Sachen Textverarbeitung in der 
Bundesrepublik, wo man nach 
Angaben des unabhängigen Markt- 
forschungsinstituts Dataquest mit 
Word bereits 1988 das hierzulande 
meistverkaufte Softwarepaket 
überhaupt anbot. 


a wir davon ausgehen, daß Sie sich als Leser 

des Microsoft System Journals bereits mehr 
oder weniger gut mit Microsoft Word auskennen, 
wollen wir in diesem Artikel nur die neuen Fea- 
tures von Word 5.0 kurz vorstellen. Daran an- 
schließend gehen wir dann auf die neuen Desk- 
top Publishing-Fähigkeiten und die verbesserten 
Möglichkeiten der Makrosprache etwas inten- 
siver ein. 


Die neuen Features 


Wie sein Vorgänger, setzt das neue Microsoft 
Word 5.0 erneut umfangreiche und zukunftswei- 
sende Standards für den Markt der professionel- 
len Textverarbeitung: Eine Vielzahl neuer und 
stark praxisorientierter Funktionen, die weit über 
die herkömmlicher Texterfassung hinausgehen, 
macht diese Version, die sowohl unter MS-DOS 
wie auch unter MS OS/2 lauffähig ist, noch viel- 
seitiger und bedienerfreundlicher. Die wesent- 
lichen neuen Features, die das noch schneller 
gewordene Microsoft Word 5.0 zu einem High- 
End-Textverarbeitungsprogramm machen, sind: 

« Seitenumbruch im Hintergrund 

® Darstellung von Textspalten nebeneinander 

* Integration von Grafik in vielen Formaten 

® absolute Positionierung von Objekten wie Ab- 
sätzen oder Bildern auf einer Seite 

® Layoutkontrolle in WYSIWYG-Darstellung 

° erweiterte Rechtschreibprüfung 

° deutscher Thesaurus 

* frei wählbare automatische Sicherung 

° Auswahl von Laufwerken und Verzeichnissen 
am Bildschirm 

* Erweiterung der Menü-Zusätze auch mit Fen- 
ster-Optionen 

Setzen von Textmarken 

erweiterte Querverweise 

verbesserter Dateimanager 

erweiterte Makro-Sprache 

vereinfachtes Setzen der Tabulatoren 

einfache Konvertierung in andere Textformate 
flexible Übertragen-Optionen 

beidseitiges Drucken und Farbdruck 
Druckfarbe für Zeichenformatierung 
installierte Bildschirmtreiber 

Nutzung von Expanded Memory 

MS OS/2-Unterstützung 

Doch lassen Sie uns die neuen Eigenschaften 
von Word etwas genauer betrachten. 


Rechtschreibprüfung 

jetzt voll integriert 

Die erhöhte »Intelligenz« von Microsoft Word 5.0 
zeigt sich auch im Umgang mit der deutschen 
Sprache: Das Programm verfügt über ein inte- 
griertes und sehr bedienerfreundliches Recht- 
schreibprogramm, das 130.000 Wörter kennt 
und für das nun keine extra Arbeitsdatei mehr 
erstellt werden muß. 


Lin.$: REEERE ER) FEERBERE En. 
Sobald Sie den Befehl Bibliothek 
gewählt haben, beginnt Word 
überprüfen: muß also ae 
separater Beichl Prüfen werden, wie das 
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den ganzen ] Text-Ausschnitt 
ist teilweise 
in ihren 
| werden können.‘ 
3 Die Korrekturen werden jetzt 
vorgenommen und nicht erst bein 
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Rechtschreibung 
Ihren Text zu 


Würter 
angezeigt 


Sichthen, damit unbekannte 
inhaltlichen Zusammenhang 


sofort in 
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Bildschirme 
Bildschirnen 
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Bildschirnes 
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Sobald Sie den Befehl Bibliothek Rechtschrei- 
bung gewählt haben, beginnt Word 5, Ihren Text 
zu überprüfen; es muß also kein separater Befehl 
Prüfen gewählt werden, wie das bei früheren 
Versionen der Fall war. 

Der Rechtschreibungs-Ausschnitt nimmt auch 
nicht mehr den ganzen Bildschirm ein. Der Text- 
Ausschnitt ist teilweise sichtbar, damit 
unbekannte Wörter in ihrem inhaltlichen Zusam- 
menhang angezeigt werden können. 

Die Korrekturen werden jetzt sofort im Text 
vorgenommen und nicht erst beim Verlassen des 
Rechtschreibprogramms. Außerdem dürfen sie 
auch Leerzeichen und Interpunktionszeichen 
enthalten. 

Eine weitere wichtige Verbesserung: Sie kön- 
nen nun die Befehle des total neu gestalteten 
Menüs Bibliothek Rechtschreibung auch in Makros 
verwenden. 


Wie sagt man doch 

gleich auch noch? 

Ein nicht seltener Fall: Das richtige Wort liegt 
Ihnen auf der Zunge, fällt Ihnen aber partout 
nicht ein. Sie können in einem solchen Fall 
natürlich in einem Lexikon für sinn- und sachver- 
wandte Wörter nachschlagen - sofern Sie eines 
zur Hand haben. 

Sie können aber auch den neuen Thesaurus 
von Word benutzen: Dieses elektronische Lexi- 
kon bietet Ihnen zu einem markierten Wort 
gleichwertige Synonyme an. Microsoft Word 5.0 
kann dabei auf 220.000 Begriffe zurückgreifen! 


Beni 
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Ihnen aber icht cin. 
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Betriebssystem- und Netzwerk- 
Unterstützung wurden verbessert 
Microsoft Word 5.0 unterstützt die Betriebs- 
systeme MS-DOS und MS OS/2. Dabei stellt die 
neue Version selbständig fest, ob sie unter MS- 
DOS, MS OS/2 bzw. dem MS LAN-Manager 
gestartet wurde und konfiguriert sich entspre- 
chend von selbst. Ein Vorteil, der besonders bei 
der Installation im Netz zum Tragen kommt, da 
Word 5.0 von ein und demselben Server gestar- 
tet werden und sowohl auf MS-DOS- als auch MS 
OS/2-Workstations laufen kann. Damit ist 
Microsoft Word 5.0 prädestiniert auch für den 
Einsatz in gemischten Netzen. 

Bisher war eine spezielle Netzwerk-Version 
erforderlich, um mehreren Workstations den Zu- 
griff auf Word zu ermöglichen. Word 5 dagegen 
kann jetzt standardmäßig sowohl in einem Ein- 
zelbenutzersystem als auch in einem Netzwerk 
laufen. 

Zur Installation in einem Netzwerk wird Word 
einfach auf einem Server eingerichtet; anschlie- 
ßend müssen dann nur noch die einzelnen Ar- 
beitsstationen für Word eingerichtet werden. Um 
Word auf dem Netzwerk-Server einzurichten, 
führen Sie das Setup-Programm aus und wählen 
die Option »Netzwerk«; zum Einrichten der Ar- 
beitsstationen führen Sie auf jeder eine spezielle 
Version von dem Setup-Programm aus. 

An Ihrem Arbeitsplatz-PC können Sie mit ihren 
eigenen Textbausteindateien, Druckformatvor- 
lagen und Wörterbüchern arbeiten und mit dem 
Befehl Zusätze oder mit anderen Befehlen selbst 
Standardeinstellungen festlegen. 

Denken Sie daran, daß Sie gemäß Lizenzver- 
trag für jeden Netzwerkbenutzer, der mit 
Microsoft Word arbeitet, ein Handbuch und eine 
Lizenz erwerben müssen. Diese sind in Form von 
Microsoft Word Arbeitsstations-Pakets erhältlich. 


Querverweise werden automatisch 
aktualisiert 

Wenn Sie oft Querverweise in Ihre Texte ein- 
fügen, wird sich die neue Querverweisfunktion 
von Word als äußerst zeitsparend erweisen. Im 
Moment gehen Sie wahrscheinlich folgender- 
maßen vor: 

Während des Erstellens und Überarbeitens 
eines Textes geben Sie den Querverweistext 
vermutlich so ein: »Sehen Sie dazu auf Seite x 
nach«, oder »Siehe Abbildung x«. Sie geben den 
Buchstaben »x« anstelle der Seitenzahl oder Ab- 
bildungsnummer ein, weil Ihnen die betreffende 
Nummer erst nach dem endgültigen Sei- 
tenumbruch bekannt sein wird. Wenn der dann 
festliegt, bestimmen Sie die korrekten Querver- 
weisnummern und fügen sie anstelle der »x« in 
Ihren Text ein — und hoffen, daß sich der Um- 
bruch dadurch nicht mehr verschiebt. 

In Word 5 können Sie Textabschnitte, auf die 
Sie verweisen möchten, auch speziell markieren. 
Wenn Sie einen Querverweis erstellen möchten, 


44Bild 1: 

Die Rechtschreibhilfe 
wird jetzt nicht mehr 
separat geladen, 
sondern ist voll in 
Word integriert. 
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Sollte Ihnen ein Wort 
nicht gefallen, wäh- 
len Sie mit dem 
Thesaurus einfach 
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>> Bild 4: 

Hier wurde gerade 
ein rechter Tab mit 
dem Mauszeiger ein- 
gerichtet. 


> Bild 3: 

Im wesentlich 
erweiterten Menü 
»Zusätze« kann die 
automatisch Speiche- 
rung mit Intervall 
und Abfrage ein- 
gestellt werden. 
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geben Sie an der betreffenden Stelle einen spe- 
ziellen Code ein. Soweit gleicht dies dem oben 
erwähnten Verfahren, in dem die Stelle, an der 
später eine Nummer eingefügt wird, mit einem 
»x« markiert wird. Wenn Sie jedoch diesen spe- 
ziellen Code verwenden, fügt Word beim Druk- 
ken des Texts die korrekten Nummern auto- 
matisch ein. 

Das Verfahren sieht etwa folgendermaßen aus: 
Sie kennzeichnen mit Format tExtmarke z.B. den 
Text auf der Seite, auf die Sie hinweisen wollen. 
An der Stelle, an der der Querverweis erscheinen 
soll, geben Sie Seite:, dann den Namen der 
Textmarke ein und und drücken F3. Dadurch 
machen Sie aus dem Querverweis einen Textbau- 
stein, ähnlich den vorgegebenen wie Datum oder 
Seite. Der Abschnitt könnte dann so aussehen: 
Sehen Sie dazu auf Seite (Seite:Text) nach. 

Mit dieser Funktion können Sie automatische 
Querverweise auf Seitenzahlen, Absatz- und 
Fußnotennummern erstellen. Sie können auch 
selbst eine Serie von Elementen (zum Beispiel 
Tabellen oder Illustrationen) festlegen und die 
einzelnen Elemente von Word automatisch 
numerieren lassen. Wenn Sie dann einen Quer- 
verweis auf eines dieser Elemente erstellen, wird 
Word die betreffende Nummer automatisch ein- 
fügen. 


Nichts geht mehr ... 
... verloren 
Die neue automatische Speicherfunktion bietet 
Ihnen die Möglichkeit, während der Arbeit auto- 
matische Sicherungskopien Ihrer Dateien erstel- 
len zu lassen. Sie geben den gewünschten Zeit- 
abstand ein und Word wird automatisch alle 
Änderungen speichern, die Sie seit dem letzten 
Speichervorgang (sei er nun automatisch oder 
mit dem Befehl Übertragen Speichern eingeleitet 
worden) vorgenommen haben. Die Sicherungs- 
kopien, die mit der Funktion Auto-speichern er- 
stellt worden sind, beinhalten alle Texte, alle 
Druckformatvorlagen und die aktuelle Textbau- 
steindatei. 
AUSSCHNITT ZUSATZE Ausschnitt Hr.: 1 
Verborgener Text sichtbar: (Ja)Mein 


Sonderzeichen sichtbar: NeintTeilweise)Alle 
Zeilenumbrüche: (Ja)Nein 


Zeilenlinenl:(da)lNein 
Layout:(Ja)Nein 
Gliederung: Jah in) 
Druckfornatspalte: (Ja)Nein 
ALLGEMEINE ZUSATZE Mernton aus: Jalhein) Kurzinformation: JaNeim) 
Malleinheit: (Zoll Wa 10er-Teilung IZer-Tellung Punkt 
Seitenumbruch: (Auto)Marmiel | 
Auto-xpeichern 
Nenü sichtbar:(tJa)Nein 
Dexinaltremzeichen: .(,) 
Abstand Tabstopps: 9,19" 


Rlldschirm: 5 
Farben: 
Auto-speichern nit Bestätigung: (Ja)Nein 
Nusschnittsrahnen: GHRiNeln 
Zeitfornat: 12124) 
Zeilemmmern: JalNein) 
Geschwindigkeit: 3 
Rechtschreibung: CiNWORDSNSPELL-GE .LEX 
Geben Sie bitte das Intervall für Autospeichern in Minuten an, 8 für nicht! 


Leerzeilen zählen: Jalhein) 
Liniemzeichen: (|) 


Sie können Word auch anweisen, vor jedem 
Speichervorgang eine entsprechende Bestätigung 
auszuführen. Wenn dann bei der Arbeit plötzlich 
nichts mehr geht, sehen Sie sich die Meldungs- 
zeile an. Dort werden Sie von Word gefragt, ob 
Sie wirklich speichern wollen. Auf diese Weise 
könne Sie verhindern, daß Bearbeitungen, die 
Sie vielleicht gar nicht übernehmen wollten, 
automatisch gesichert werden. 


Sollte es während der Arbeit zu einem Absturz 
kommen, sind die Dateien wiederherstellbar. 
Beim erneuten Starten stellt Word automatisch 
fest, ob Dateien wiederhergestellt werden 
müssen und macht das dann auf Wunsch für Sie. 


Schnelleres und leichteres Setzen 

der Tabstopps 

Die Tabstopps lassen sich jetzt sowohl mit Hilfe 
des Befehls Format Tabulator als auch mit der 
Maus wesentlich einfacher setzen. So können Sie 
die Markierung auf dem Zeilenlineal auf die ge- 
wünschte Position bringen und einen Tabstopp 
setzen, indem Sie einfach den ersten Buchstaben 
der gewünschten Ausrichtung eingeben: L für 
links, Z für zentriert, R für rechts, D für dezimal 
oder V für eine vertikale Linie. Sie können die 
gewünschte Ausrichtung natürlich auch im Be- 
fehlsfeld Ausrichtung des Befehls Format Tabula- 
tor Setzen (die einzig mögliche Methode in Word 
4) vornehmen. 

Wenn Sie sich das Zeilenlineal anzeigen las- 
sen, können Sie die Tapstopps bequem mit der 
Maus setzen, verschieben oder löschen, indem 
Sie einfach auf die betreffende Stelle klicken 
bzw. den Mauszeiger auf dem Zeilenlineal zie- 
hen. Sie müssen den Befehl Format Tabulator 
Setzen also überhaupt nicht mehr wählen. Sie 
können sogar Absatzeinzüge ändern, indem Sie 
auf das Einzugssymbol klicken und es über das 
Zeilenlineal ziehen. 

lassen, können Sie die Tapstopps bequen mit der 


Maus setzen, verschieben oder 
Sie einfach auf die betreffende 


löschen, indem 
Stelle 


 TRRRERUTESELETPRER VERULTEETURELTERE DELZSH (KILETEERTS | 
Wenn Sie sich das Zeilenlineal *% anzeigen 


klicken 


Das Zeilenlineal erleichtert Ihnen auch das Er- 
stellen und Überprüfen von Tabellen, denn die 
Einteilung des Lineals wird automatisch an die 
proportionalen Schriftarten angepaßt (Bild 4). 
Auf dem Bildschirm können proportionale 
Schriftarten nicht als solche angezeigt werden; 
wenn Sie also Schriftarten wie zum Beispiel 
Times-Roman und Helvetica verwenden, ändert 
Word die Markierungen auf dem Zeilenlineal 
automatisch so, daß die Tabellen auf dem Bild- 
schirm genauso ausgerichtet werden wie im ge- 
druckten Text. 


Mit F1 geht's in alle Verzeichnisse 

Wenn Sie eine Datei von der Diskette oder Fest- 
platte laden möchten, können Sie nun die Taste 
drücken, um Dateien von einem beliebigen 
Verzeichnis oder Unterverzeichnis anzeigen zu 
lassen und auszuwählen. Dabei kann es sich um 
Textdateien, eine Textbausteindatei, einen Druk- 
kertreiber oder beliebige andere Dateien han- 
deln. Damit sind Sie in der Lage, eine Datei aus 
einem anderen Laufwerk oder Verzeichnis zu 
laden, ohne den gesamten Suchweg eingeben 
oder die Angaben im Befehlsfeld Lauf- 
werk/Verzeichnis: des Befehls Übertragen Optio- 
nen ändern zu müssen. 


E:SSORDSS® IKT 
CAPTURE. TKT 
CHARTER. TAT 


MACRDONU TAT UORD_RIF.TXT fc:} 
MAKEUID.TRT ZATEST.TXT 1D:1 
0S2_IMmPu.TXT t..ı 1122) 


A —— |: 


WORD_DEA.TXT 


Die Liste, die angezeigt wird, wenn Sie die 
Taste drücken, enthält sämtliche Dateien im 
aktuellen Verzeichnis, die Namen aller eventuel- 
len Unterverzeichnisse des aktuellen Verzeichnis- 
ses, die Laufwerksbezeichnungen Ihres Systems 
sowie eine Bezeichnung für das übergeordnete 
Verzeichnis des aktuellen Verzeichnisses. 

Laufwerks- und Verzeichnisnamen sind in 
eckigen Klammern eingeschlossen, um sie von 
ladbaren Dateien zu unterschieden; so zeigt zum 
Beispiel [A:] Laufwerk A: an, [BERICHTE] weist 
auf ein Unterverzeichnis mit dem Namen BE- 
RICHTE hin, und das Symbol [..] deutet auf ein 
übergeordnetes Verzeichnis hin. Wenn Dateien 
aus einem anderen Laufwerk oder Verzeichnis 
aufgelistet werden sollen, wählen Sie einfach die 
betreffende Bezeichnung aus der Liste und drük- 
ken nochmals die Taste - und wenn Sie da- 
bei eine Liste in Laufwerk A anzeigen lassen 
wollen, ohne eine Diskette eingelegt zu haben, 
nimmt Word Ihnen das auch nicht übel. 


Verknüpfen von Texten mit Tabellen, 
Grafiken und sogar anderen Texten 
Ähnlich wie beim Verknüpfen von Kalkulations- 
tabellen oder Grafiken können, Sie auch den 
Text, an dem Sie gerade arbeiten, mit einem 
anderen Word-Text oder mit einem Teil davon 
verknüpfen. 


Gebeu Sie bitte den Namen der Textmarke ein oder yahlen Sie einen nit Fit 


Nehmen wir an, Sie haben eine Hauptpreisliste 
aller Ihrer Produkte und möchten für bestimmte 
Produkte separate Broschüren erstellen. Mit 
Word können Sie eine bestimmte Preisgruppe in 
der Hauptpreisliste markieren und den betref- 
fenden Abschnitt mit dem Text einer Broschüre 
verbinden. Nach jeder Preisänderung, die in der 
Hauptpreisliste vorgenommen wird, können Sie 
dann mit der automatischen Aktualisierungs- 
Funktion von Word die gleichen Änderungen 
auch in der Broschüre vornehmen lassen. 

Zum Markieren des zu verknüpfenden Text- 
abschnitts verwenden Sie die neue Funktion 
Textmarke von Word; anschließend wird der 
Textabschnitt mit Hilfe des Befehls Bibliothek 
verKnüpfen Dokument mit dem aktuellen Text 
verknüpft. 


Komfortable Bildschirmanzeige mit 

acht Betriebsarten 

Im Befehlsfeld Bildschirm: des Befehls Zusätze 
können Sie jede beliebige Text- oder Grafik-Be- 
triebsart wählen, die von Ihrem Bildschirm-Adap- 
ter unterstützt wird. 


H l "PP = (nbschalten) 
Ausschnittsrahmen: Mustertext 
Meldungen: Mustertext 
Statuszelle ® 


Nemis: Mustertext 
Dpt lonsnemi : Muntertext 
8,5 Punkte oder weniger: 
9,0 bis 16 Punkte: Mustertext 
10,5 bis 12 Punkte: Mıstertext 
12,5 bis 14 Punkte: Mustintoxi 
Mehr als 14 Punkte: 
Fett: Mustertext 
Kursiv: Nuniertext 
Unterstrichen: "» 
Doppelt unterstrichen: " 


Verborgener Text: 

Burchgestrichen: 

Fett und kursiv: Mistierinst 

Fett und Unterstrichen: uster io» 
Kursiv und Unterstrichen: 


ZeileniinealitJaNein 
Layout: Jahr in? 
Glinderung: Inte in) 


Verborgener Text sichtbar:tJa)Nein 
Sonderzeichen sichtbar: NeintTeilweisejalle 
Zeilenumbrüche: (Ja Ne in 
Druckformatspa te: (Ja )Mein 
ALLGEMEINE ZUSATZE Yarnton aus: Jatfein) Kurz informat ion: Jafhein} 
Haßeinheit:(Zoil)C« 10er-Teilung IZer-Teilung Punkt 
Bildschirm: 1 Se itemunbruch: (fsıto)Manum 
Farben: | Mıito-speichern: 10 
Auto-speichern nit Bestätigung: Gilde in Memi sichtbar: (JaMein 
Busschnittsrahnen: (Ja)Nein Dez. imaltrennzeichen: .(,) 
Zeitformat: 12124) nbstand Tabstopps: 0,19“ 

Zei lennannern: Jalnein) Leerzeilen zählen: Jalmein) 
Geschwindigkeit! I Linienzeichen: {|) 
Rechtschreibung: C: WORDSNSPELL-GE.LEX 

Fl zur Elemenlauswahl. Buchstaben oder BILD MNCH UBEN/UNTEN- TASTE für Farbet 


In Word 4 waren nur die Betriebsarten Text 
und Grafik möglich. Jetzt sind es auf einem EGA- 
Monitor drei Textbildschirme mit 25, 43 und 50 
Zeilen sowie fünf Grafikdarstellungen mit 25, 30, 
34, 43 und 60 Zeilen. Word 5 merkt sich dabei 
die aktuelle und die vorherige Einstellung im Be- 
fehlsfeld Bildschirm:, und Sie können mit der 
Tastenkombination zwischen diesen 
beiden Betriebsarten umschalten. 


Druckerunterstützung 

erweitert und verbessert 

Der endgültige Prüfstein eines Textverarbei- 
tungsprogramms liegt in der Qualität des ge- 
druckten Textes. Word bietet seit der ersten Ver- 
sion eine ausgefeilte Druckerunterstützung; 
dadurch war es Ihnen möglich, die Leistungs- 
fähigkeit Ihres Druckers voll auszunutzen und 
höchste Druckqualität zu erzielen. In Word 5 
wurden mehr als 50 neue Druckermodelle be- 
rücksichtigt. Außerdem wurde das Handbuch mit 
den Druckerinformationen gründlich über- 
arbeitet und aktualisiert. 

Im Befehl Druck Option können Sie nun auch 
außer der Druckertreiberdatei (DBS) Ihr speziel- 
les Druckermodell angeben. Wenn Sie zum Bei- 
spiel einen HP Laserjet II haben, könnten Sie im 
Befehlsfeld Drucker: HPLASMS und im Befehlsfeld 
Modell: Laserjet Serie II wählen. Wenn Sie in 
den beiden Befehlsfeldern jeweils die Taste 
drücken, wird eine Liste der verfügbaren Optio- 
nen angezeigt. 

Bei Laserdruckern berücksichtigt Word jetzt 
auch die Papierbereiche, die nicht bedruckt wer- 
den. Sie können somit die exakte Papiergröße 
und genauen Seitenränder angeben, ohne sich 
um den tatsächlichen Druckbereich kümmern zu 
müssen. Für gewisse Laserdrucker werden auch 
der manuelle Papiervorschub und der Vorschub 
von Briefumschlägen unterstützt. 

Sollten Sie mit einem PostScript-Drucker 
arbeiten, können Sie alle geradzahligen 
Schriftarten von bis zu 126 Punkten verwenden, 
die von Ihrem Drucker unterstützt werden. 

Wenn Sie einen Drucker haben, der beidseitig 
drucken kann (wie zum Beispiel der HP Laserjet 
2000, Canon LBP-811R oder Toshiba Page 
Laser), geht auch das im neuen Befehlsfeld Beid- 
seitig: einzustellen. Haben Sie einen HP Laserjet 


44 Bild 5: 

Die Auswahl der 
Dateien beschränkt 
sich nicht mehr nur 
auf das eingestellte 
Verzeichnis. 


“Bild 7: 

Wie Sie sehen, 
können Sie einen 
Farbmonitor im 
Textmodus beliebig 
bunt gestalten. 


44 Bild 6: 

Um Textdateien zu 
verknüpfen, können 
Sie eine Textdatei 
und eine Textmarke 
angeben bzw. mit Fl 
auswählen. 
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> Bild 8: 

Word merkt sich auf 
Wunsch das Ver- 
zeichnis, in dem 
gearbeitet wird. 


>> Bild 9: 

Die Grafiken können 
ebenso ausgewählt 
werden wie Dateien 
— es sei denn, Sie 
wollen den Punkt- 
befehl direkt ein- 
geben. 
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2000, Laserjet II D, Mannesmann Tally 910, 
Panasonic Laser 4450, Canon L8P-811-R, Toshi- 
ba Page Laser oder einen PostScript-Drucker, 
dann können Sie im gleichen Text sowohl Seiten 
im Hochformat als auch Seiten im Querformat 
drucken. 

Wenn Sie mit einem Farbdrucker arbeiten, 
können Sie dem ausgewählten Textabschnitt im 
Befehlsfeld Farbe: des Befehls Format Zeichen 
eine Farbe zuweisen, genauso, wie Sie die Zei- 
chen fett oder kursiv formatieren würden. Sie 
können auch Rahmenlinien- und Hintergrund- 
schattierungsfarben bestimmen. 


UBERTRAGEN OPTIONEN Laufwerk/Verzeichnis: E:MSJ35 WORDS 


Speichern zwischen Sitzungen ia 
Wahlen Sie bitte eine Optiont r 


Neues im Menü »Übertragen Optionen« 
Schluß mit dem Ärger, daß das zuletzt eingestellt 
Verzeichnis nach dem Verlassen von Word ver- 
lorengeht. Das Laufwerk und Verzeichnis, das Sie 
im Menü Übertragen Optionen für das Laden und 
Speichern von Dateien festlegen, kann auf 
Wunsch als Standardeinstellung bestimmt wer- 
den, die zu Beginn jeder Word-Arbeitssitzung 
automatisch gültig ist. 


Word als echtes 
Desktop Publishing- 
Werkzeug 


Welche Möglichkeiten zum Desktop Publishing 
Word 5 nun hat, sehen Sie am besten am neuen 
Microsoft System Journal: Die Ausgabe wurde 
komplett mit Word 5 gestaltet, auf einem Post- 
Script-Drucker zur Korrektur ausgedruckt und 
die Filme auf einer Linotronic 300 belichtet. 

Die wohl mit interessantesten Innovationen 
von Word 5 - neben den Makro-Neuheiten — sind 
die verschiedenen Funktionen zur Gestaltung des 
Seitenlayouts, mit denen Sie raffiniert ausgelegte 
Broschüren, Berichte, Werbematerial, illustrierte 
Bücher und ähnliches erstellen können. Die 
neuen Publishing-Funktionen von Word bieten 
Ihnen folgende Möglichkeiten: 

° Importieren, Festlegen der Größe und Drucken 
von Grafiken, die mit verschiedenen Program- 
men erstellt wurden. 

« Positionieren eines beliebigen Absatzes, der 
einen Text oder eine Grafik enthalten kann, an 
einer bestimmten, fixierten Stelle auf der Seite. 
Der bestehende Text wird automatisch um den 
positionierten Absatz herum ausgedruckt. 

° In der Betriebsart Layout werden Spalten 
nebeneinander auf dem Bildschirm angezeigt; 
positionierte Textabschnitte und Grafiken wer- 
den durch einen entsprechenden Rahmen dar- 
gestellt. 

* Überprüfen des Seitenlayouts vor dem Druk- 
ken. In der Betriebsart Druck Layoutkontrolle 


zeigt Word wahlweise eine oder zwei Seiten so 
auf einem Grafikbildschirm an, wie sie gedruckt 
aussehen werden. Dabei sind alle einzelnen Ele- 
mente erkennbar, einschließlich der Grafiken, 
positionierten Absätze und Kopf-/Fußzeilen. 

« Einfaches Kombinieren von unterschiedlichen 
Spaltenformaten auf der gleichen Seite. 

° Aktivieren der Option Zeilenumbrüche, damit 
Word die Einteilungen auf dem Zeilenlineal den 
Proportionalschriftarten anpaßt. 

° Hinzufügen von Hintergrundschattierungen 
einer bestimmten Intensität. 


Vereinfachte 

Grafik-Integration 

Sie können nun Grafiken auf dieselbe Weise 
importieren wie Daten aus Kalkulationstabellen, 
d.h. mit dem Befehl Bibliothek verKnüpfen. Dabei 
kann jede Grafik beliebig vergrößert oder ver- 
kleinert werden - und das mit den original Pro- 
portionen oder verzerrt. Microsoft Word 5 unter- 
stützt dabei folgende Grafikformate: Windows 
Clipboard Bitmapped, PC-Paintbrush PCX-For- 
mat, Pageview Bitmapped, Postscript-EPS- 
Dateien und -Druckdateien, Lotus PIC-Grafiken, 
HPGL- und TIFF-Dateien. 


UORDS.TXT 
t..) 


in: ) 
Ic: 


BIBLIOTHEK VERKMUPFEN GRAFIKEN Dateiname: WNLIEERRTE] 
Format: Capture Ausrichtung: Zenteiert 
Breite der Grafik: 3° Hohe der Grafik: 2,135" 
Anfanysabstand: 9" Endeabstand: 0” 

Geben Sie bitte einen Bateinanen ein oder wählen Sie einen nit Fit 


Außerdem wird zu der neuen Word-Version 
das Capture-Programm mitgeliefert, mit dem Sie 
vom Bildschirm — aus beliebigen Programmen 
heraus — Word-kompatible Grafiken erzeugen 
können. Als Beispiele für die Arbeit von Capture 
sehen Sie die Bilder dieses Artikels und viele 
andere Bilder dieser Ausgabe. 


Lassen Sie den Text um Objekte fließen 
An jede beliebige Stelle auf einer Dokumenten- 
seite können Sie mit Microsoft Word 5 nun Ab- 
sätze, die Text oder Grafik (auch Kopf-/ Fuß- 
zeilen) enthalten sollen, über den Befehl Format 
Position fest positionieren. Der Text »fließt« um 
die Objekte herum (Bild 12). Sie können die 
Breite des Absatzrahmens bestimmen und fest- 
legen, wieviel Abstand zwischen dem Absatz- 
rahmen und dem benachbarten Text eingehalten 
werden soll. 

Mit dieser Möglichkeit — es lassen sich dafür 
auch Muster-Druckformatvorlagen anlegen - 
schafft Microsoft mit Word 5 Gestaltungsvaria- 


tionen, die bislang nur mit DTP-Programmen 


realisierbar waren. 
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Im Layout arbeiten 

Sie können sich das Gestalten des Seitenlayouts 
wesentlich erleichtern, wenn Sie in der Betriebs- 
art Layout arbeiten, die Sie entweder mit dem 
Befehl Zusätze oder durch Drücken der Tasten- 
kombination aktivieren. In dieser 
Betriebsart zeigt Word nicht nur Spalten bzw. 
Absätze nebeneinander an, sondern auch die 
Rahmen der Grafik- oder Textabsätze, die mit 
dem Befehl Format Position positioniert wurden. 
Die eigentlichen Grafiken werden jedoch nicht 
angezeigt. 

Sie können somit am 


den, wie sie auf dem Drucker ausgegeben wer- 
den sollen - Stichwort WYSIWYG. Dabei werden 
auch alle Grafiken (außer Druckdateien ein- 
schließlich Postscript) sowie die Farben der Gra- 
fiken und Zeichen sichtbar, sofern ein entspre- 
chender Farbdruckertreiber geladen wurde. 


Kombinieren von 

unterschiedlichen Spaltenformaten 

auf der gleichen Seite 

Mit den bisherigen Word-Versionen mußte man 
etwas tricksen, um z.B. eine einspaltige Über- 
schirft über einen zweispaltigen Text zu bringen 
— und das funktionierte auch nur, wenn die 
Überschrift am Seitenanfang und nicht irgendwo 
in der Mitte stehen konnte. 

Jetzt geben Sie einfach einen Bereichswechsel 
((Ctr1 ][Return)) ein und wählen anschließend im 
Befehlsfeld Bereichswechsel: des Befehls Format 
Bereich Layout die Option Fortlaufend, wenn Sie 
die Spaltenformatierung einer Seite ändern, d.h. 
von einem einspaltigen auf ein dreispaltiges 
Layout wechseln möchten. 


So sehen Sie den Zeilenfall 

Wenn Sie Proportionalschriftarten verwenden 

und im Befehlsfeld Zeilenumbrüche: des Befehls 

Zusätze die Option Ja gewählt haben oder ein- 
fach die 


Monitor die Druckbild- 
darstellung kontrollieren 
und gegebenenfalls 
ändern, ohne den Weg 
über den Ausdruck gehen zu müssen. 

Einen Spaltenumbruch können Sie jetzt z.B. 
ganz einfach einfügen (d.h. wenn Sie eine Spalte 
beenden und oben in der nächsten Spalte fort- 


fahren möchten), indem Sie 
drücken. 


DRIICK LAYOLTKONTROLLE: Beenden Gehezu Oyt innen Druck 


x 
Benutzen Sie die BILD NACH UBEN-UNTEN-TASTE, un einen Bildlauf durchzuführen? 
m 57m T za VEC 


nr 


Die Kontrolle des Layouts 
Microsoft Word 5 enthält nun auch eine Layout- 
kontrolle, mit der am Monitor die Ganzseiten- 
ansicht des Dokuments ein- oder zweiseitig mög- 
lich ist. 

Damit können auf dem Bildschirm die einzel- 
nen Dokumentseiten genau so dargestellt wer 


WORD 5.0 


Tastenkombination 

Alt F7 betätigen, wird 
die Einteilung auf dem 
Zeilenlineal der 
verwendeten Schriftart und dem Schriftgrad 
angepaßt, da die eigentlichen Proportional- 
schriftarten nicht als solche auf dem Bildschirm 
angezeigt werden können. 

Somit können Sie sich das Erscheinungsbild 
Ihres gedruckten Textes besser vorstellen, was 
besonders bei Tabellen von Vorteil ist. Wenn Sie 
in der Betriebsart Layout arbeiten, wählt Word 
automatisch diese Betriebsart. 


Schattieren Sie 

hervorzuhebende Absätze 

Mit dem Befehl Format Rahmen können nun den 
Absätzen Hintergrundschattierungen hinzugefügt 
werden (vorausgesetzt, Ihr Drucker unterstützt 
die Schattierung). Geben Sie dazu im Befehlsfeld 
Hintergrundschattierung: einfach eine entspre- 
chende Prozentzahl zwischen O (keine Schattie- 
rung) und 100 (schwarz) ein. 

Dafür gibt es in diesem Heft mit den hinterleg- 
ten Listings ebenso ein Menge Beispiele wie für 
die Möglichkeit, Seiten zu spiegeln — so gesche- 
hen mit der Marginalspalte für Bildunterschriften 
und die Fußzeilen. Wenn Sie im Befehlsfeld Rän- 
der spiegeln: des Befehls Format Bereich Seiten- 
rand die Option Ja wählen, werden gegenüber- 
liegende Seiten identische innere und äußere 
Seitenränder aufweisen. 


44 Bild 10: 

Der zentrierte 
Schriftzug »Word 
5.0« ist hier in der 
Betriebsart Layout 
dargestellt. 


44 Bild 12: 

Dieser Absatz wurde 
einfach zwischen den 
Seitenrändern 
zentriert. 


44 Bild 11: 
Erkennen Sie die Sei- 
ten dieser Abbil- 
dung? Sie wurde mit 
dem Capture-Pro- 
gramm von einer 
Layoutdarstellung 
dieser Ausgabe 
gemacht. 
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Leistungsumfang der Makros 
wesentlich angereichert 


An den Makrofunktionen von Word 5 sind zahl- 
reiche Verbesserungen vorgenommen worden, 
besonders im Bereich der Sonderanweisungen, 
die beim Schreiben von Makros eingefügt wer- 
den können. 

An dieser Stelle sei auch gleich ein Hinweis 
angebracht: Da einige Word-Menüs geändert 
wurden, müssen die mit Word 4 erstellten 
Makros konvertiert werden, bevor Sie sie in der 
Version 5 ausführen. Dazu gibt es auf der Hilfs- 
programmdiskette das Programm MACROCNV. 
EXE mit den Erläuterungen zur Handhabung in 
der Textdatei MACROCNV.TXT. 

Doch kommen wir nun zu den Erweiterungen 
der Makrosprache. 


Neue reservierte Variablen. 

Mehrere neue reservierte Variablen erschließen 
ungeahnte Möglichkeiten für die Makro-Anwen- 
dung: 

Ausschnitt zum Bestimmen oder Ausfindig- 
machen der Nummer des aktuellen Ausschnitts. 

Mit der Varaible Ausschnitt können Sie die 
Nummer des Ausschnitts feststellen, in dem Sie 
sich gerade befinden. 

«AWENN Ausschnitt = "3"» 

Sie können aber auch in einen bestimmten 

Ausschnitt wechseln: 

«BESTIMMEN Ausschnitt = "3"» 

Echo zum Steuern der Bildschirm-Aktualisierung 
während der Makro-Ausführung. 

Mit der Variablen Echo läßt sich die Anzeige 
der Bildschirmaktivitäten ausschalten und damit 
eine höhere Arbeitsgeschwindigkeit erreichen. 
Die beiden zulässigen Werte sind an und aus. 
«BESTIMMEN Echo = "an"» 

«BESTIMMEN Echo = "aus"» 

Bevor Sie den Wert ändern, können Sie ihn 

natürlich auch testen: 

«AWENN Echo = "an"» 

Eingabemodus für die leichtere Handhabung von 
Word-Eingabeaufforderung während der Makro- 
Ausführung. 

Mit der Variable Eingabemodus können Sie 

festlegen, ob die Antworten auf eventuelle Word- 
Eingabeaufforderungen vom Makro oder vom 
Anwender des Makros gegeben werden sollen, 
oder ob sie gar zu ignorieren sind. Wenn Sie z.B. 
im Makro die Speicherfunktion ausführen, kann 
es sein, daß Word einen Sicherheitsabfrage 
macht (J um Änderungen im Dokument zu spei- 
chern N wenn nicht oder ...). Sie haben eine der 
drei folgenden Möglichkeiten, diese Abfrage 
abzufangen: 
«BESTIMMEN Eingabemodus = "Benutzer"» 
«BESTIMMEN Eingabemodus = "Makro" » 
«BESTIMMEN Eingabemodus = "abschalten" » 

Word nimmt standardmäßig den Wert Makro 


an. Das Makro muß dann also auf solche Even- 
tualitäten vorbereitet sein. 

Speichern zum Wahrnehmen der Meldung SPEI- 
CHERN, mit der Word zum Sichern der Arbeit auf- 
fordert. 

Mit dieser Variablen unterstützt Word alle 
diejenigen, die umfangreiche Änderungen an 
ihren Texten vornehmen und kein Extended 
Memory besitzen. Dieser Boolsche Operator mel- 
det entweder »richtig« oder »falsch«. Er sollte bei 
Wechsel- und Sortiervorgängen, beim Erstellen 
von Inhalts- und Stichwortverzeichnissen sowie 
bei umfangreichen Bearbeitungen und kom- 
plexen mathematischen Berechnungen folgen- 
dermaßen eingesetzt werden: 

«AWENN Speichern» 

<Unt>ÜA 
«EWENN» 
Wordversion zum Feststellen der Versionsnum- 
mer des Word-Programms (vorgesehen haupt- 
sächlich für zukünftige Versionen). 


Neue Funktionen, logische Operatoren 
und Matrizen 

Einige neue Funktionen, logische Operatoren 
und Matrizen erleichtern ebenfalls den Umgang 
mit dem Programm. 

LÄNGE (auch als LEN bekannt) mißt die Länge 
einer Zeichenfolge in Anzahl der Zeichen. 

Mit dieser Funktion können Sie die Länge 
einer Konstanten oder Variablen feststellen: 
«BESTIMMEN Ergebnis = LÄNGE (Markierung) » 
«BESTIMMEN Ergebnis = LÄNGE (Feld) » 
«BESTIMMEN Ergebnis = LÄNGE (Telefonnummer) » 
INT reduziert eine Zahl auf die nächstkleinste 
Ganzzahl. 

Zu dieser Funktion muß eigentlich nicht viel 
gesagt werden, dennoch ein Beispiel: 

«BESTIMMEN Ergebnis = 
INT (LÄNGE (Markierung) /2) » 

legt die abgrundete halbe Anzahl der markier- 
ten Zeichen fest. Bei 9 Zeichen lautet das Ergeb- 
nis also 4. Um die Werte auf- bzw. abzurunden, 
addieren Sie einfach 0,5: 

«BESTIMMEN Ergebnis = 

INT( (LÄNGE (Markierung) /2)+0,5)» 

TEIL (auch als MID bekannt) entnimmt einer 
Textfolge eine bestimmte Anzahl Zeichen. Diese 
Funktion können Sie z.B. dazu nutzen, um nur 
Dateien mit einer bestimmten Endung zu laden: 
«BESTIMMEN Dateityp = 
TEIL(Dateiname, LÄNGE (Dateiname) /2)-3,3) » 
«AWENN Dateityp = "SIK"» 

Wie Sie sehen, erfordert TEIL drei verschie- 

dene Elemente. Dabei ist in diesem Fall 
LÄNGE(Dateiname)/2)-3 der Anfangspunkt für 
die drei letzten Zeichen. 
Verketten - obwohl keine benannte Funktion wie 
die obigen — erlaubt dennoch die Verkettung von 
zwei oder mehreren Textfolgen. Der Umfang der 
verketteten Zeichen darf nicht mehr als 255 Zei- 
chen betragen: 


«BESTIMMEN Zeichenfolge = Zeichenfolgel 
Zeichenfolge2 Zeichenfolge3 Zeichenfolge4» 

Die folgenden neuen Operatoren erlauben eine 
größere Flexibilität der Ausdrücke, die Sie 
schreiben können: UND, ODER und NICHT. 
Damit sind jetzt auch lästige AWENN-Schachte- 
lungen unnötig, so können Sie z.B. folgendes 
eingeben: 

«AWENN a<b UND b<(c+d)» 
«AWENN a>b ODER c>d» 

Eine weitere Möglichkeit erspart Ihnen viel 
Arbeit beim Vergeben von Variablennamen: die 
sogenannte Aufstellung (Array). Sie können 
damit eine Matrix erstellen, um in einem ein- 
zigen Arbeitsgang eine ganze Gruppe verwandter 
Variablen zu definieren. 

«BESTIMMEN Index = Ganzzahl» 

«SOLANGE Index <= Maximum» 

«BESTIMMEN Aufstellung«Index» = Wert» 
«BESTIMMEN Index = Index + Intervall» 
«ESOLANGE» 

Nach der Initialisierung der Varaiblen Index 
mit einer ganzen Zahl, wird die SOLANGE- 
Schleife bis zu einem vorgegebenen Maximalwert 
durchlaufen. In der Schleife werden die Variab- 
len, z.B. Aufstellungl, Aufstellung2, Aufstellung3 
usw., durch Hochzählen des Index mit einem 
individuellen Wert belegt. 


Noch ein paar interessante Kleinigkeiten 
Auch Makros lassen sich wiederholen. Drücken 
Sie die Taste [F4], um die Makro-Ausführung zu 
wiederholen. In Word 4 wurde dadurch nur der 
letzte vom Makro ausgeführte Befehl wiederholt; 
in Word 5 ist es das gesamte Makro. 


Wenn Die Makro-Ausführung infolge eines 
Fehlers unterbrochen wird, versucht Word, Ihnen 
wenn immer möglich die Ursache, des Abbruchs 
mitzuteilen und den Befehl oder die Anweisung 
zu identifizieren, durch den bzw. die der Ab- 
bruch verursacht wurde. Dies erleichtert Ihnen 
die Fehlerbehebung. 

Es ist möglich, Variablen in den Text der Ein- 
gabeaufforderungen und Meldungen der Makro- 
Anweisungen BESTIMMEN, ABFRAGE, MELDUNG 
und PAUSE einzufügen. Der aktuelle Wert der 
Variable wird in der Meldung oder Eingabeauf- 
forderung angezeigt. Sie können auch einen Teil 
des Makros »ausschalten«, indem Sie ihn zwi- 
schen KOMMENTAR-EKOMMENTAR-Anweisun- 
gen setzen. 

Wenn Sie die Tastenbezeichnung <CTRL UM- 
SCHALTEN UNT> in einem Makro verwenden - 
oder natürlich auch, wenn Sie dies über die 
Tastatur eingeben -, stellen Sie sicher, daß Word 
in jedem Fall zum Hauptbefehlsmenü geht, auch 
wenn es sich gerade im Muster-Menü befinden 
sollte. 


Schlußbemerkung 


Als alter Word-Anwender (bin seit der Version 1 
dabei) freue ich mich über jede neue Version und 
natürlich über all das, was wieder weiter verbes- 
sert wurde. Diesmal freue ich mich besonders 
darüber, daß ich mich noch nicht ernsthaft 
einem DTP-Programm zugewendet habe. Diese 
mit Word 5 produzierte Ausgabe des System 
Journals gibt mir da recht, oder?! 

Hartmut Niemeier 
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>> Tabelle 1: 

Die von Intel reser- 
vierten Ausnahme- 
Interrupts 


8259A 
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Der programmierbare Interrupt- 
controller 8259A: 


Steuerung von 
Ein-/Ausgabe- 
geräten 


Im Gegensatz zu Softwareinter- 
rupts, die von einem Programm 
ausgelöst werden, werden Hard- 
wareinterrupts von einem elektri- 
schen Signal, das von einem Ein-/ 
Ausgabegerät, wie einer seriellen 
Schnittstelle oder einem Festplat- 
tencontroller kommt, initiiert. Der 
Mikroprozessor kann Hardware- 
interrupts auch selbst auslösen. Die 
externen oder internen Hardware- 
interrupts werden bei der Intel- 
Prozessorarchitektur nach Priori- 
täten bedient. 


D: 8086-Mikroprozessoren-Familie (wo zu 
auch 8088, 8086, 80186, 80286 und 80386 
gehören) reserviert die ersten 1024 Bytes des Ar- 
beitsspeichers (die Adressen 0000:0000 bis 
0000:03FFH) für eine Tabelle von 256 Interrupt- 
vektoren. Jeder dieser Vektoren ist ein 4 Byte 
langer Far-Zeiger auf eine zugehörige Interrupt- 
Serviceroutine (ISR), die bei der Bearbeitung des 
zugehörigen Interrupts ausgeführt wird. Das 
Design der 8086-Familie bedingt, daß einige 
Vektoren für spezielle Zwecke verwendet werden 
(Tabelle 1). Obwohl Intel die ersten 32 Interrupts 
reserviert hat, hat IBM die Interrupts 05H bis 
1FH im Original-PC für eigene Zwecke verwen- 
det. Die meisten, aber nicht alle dieser reservier- 
ten Vektoren, werden von der Software benötigt, 
nicht von der Hardware. Die von IBM anders 
definierten Interrupts sind in Tabelle 2 aufge- 
listet. 


Interrupt Definition 

00H Division durch O 

01H Einzelschritt 

02H Nicht maskierbarer Interrupt (NMI) 
03H Breakpunkt 

04H Überlauf 

05H Array-Grenzen-Überschreitung 1 
06H Ungültiger Befehl ! 

07H Coprozessor nicht verfügbar ? 

08H Doppelfehler-Ausnahme 2 

09H Coprozessor Segment-Überlauf 2 
0AH Ungültiges Task-Zustandsregister 2 
OBH Segment nicht vorhanden ? 

OCH Stack-Ausnahme 2 

0ODH Generelle Schutzverletzung 2 

OEH Seitenfehler 3 

OFH Reserviert 

10H Coprozessor-Fehler 2 


l Nur für 80186, 80286 und 80386 Mikroprozes- 
soren 

2 Nur für 80286 und 80386 Mikroprozessoren 

3 Nur für 80386 Mikroprozessoren 


In der Mitte von Tabelle 2 sehen Sie die acht 
Hardwareinterrupt-Vektoren (08H bis OFH), die 
IBM im Original-PC verwendet hat. Diese acht 
Vektoren sind die maskierbaren Interrupts für die 
IBM-PC-Familie und Kompatible. Die zusätzli- 
chen IRQ-Signale, über die der IBM PC/AT ver- 
fügt, werden später erläutert. 

Die Interrupt-Konflikte, die in den Tabellen 1 
und 2 zu sehen sind, verursachten Kompatibili- 
tätsprobleme bei der Entwicklung der 8086- 
Familie. Für eine vollständige Kompatibilität zu 
IBM muß der Gebrauch der Interruptvektoren 
analog zu IBM implementiert sein, selbst wenn es 
Konflikte mit dem Design der CPU gibt. Zum Bei- 
spiel wird beim Überschreiten der oberen oder 
unteren Grenze eines Arrays ein BOUND-Fehler 
ausgelöst. Dieser verursacht einen Interrupt 5H. 


Aber der 80286-Prozessor, wie er in AT-kompati- 
blen Computern verwendet wird, schickt beim 
Auftreten eines BOUND-Fehlers den Bildschirm- 
inhalt an den Drucker, da IBM den Interrupt 5 
für die Printscreen-Funktion verwendet. 


Interrupt Definition 

05H Print Screen 

06H Unbenutzt 

07H Unbenutzt 

08H Hardware IRQO (Timer) 1 

09H Hardware IRQ1 (Tastatur) 

OAH Hardware IRQ2 (Reserviert) 2 
OBH Hardware IRQ3 (COM2) 

OCH Hardware IRQ4 (COMI) 

ODH Hardware IROQ5 (Festplatte) 
OEH Hardware IRQ6 (Diskette) 

OFH Hardware IRQ7 (Drucker) 

10H Bildschirm-Funktionen 

11H Ausstattungsinformationen 

12H Speichergröße 

13H Diskettenein-/ausgabe-Funktionen 
14H Serielle Schnittstellen-Funktionen 
15H Kassetten/Netzwerk-Funktionen 
16H Tastatur-Funktionen 

17H Drucker-Funktionen 

18H ROM BASIC 

19H Erneutes Starten des Systemes 
1AH Datum/Uhrzeit setzen und lesen 
1BH Control Break 

1CH Timertick 

1DH Video Parameter-Zeiger 

1EH Disketten Parameter-Zeiger 

1FH Grafische Zeichentabelle 


1 IRQ = Interrupt Anforderungs Leitung 
2 Sehen Sie auch die Bilder 7 und 8 


Arten von Hardware- 
Interrupts 


Die 8086-Mikroprozessor-Familie kann drei 
Arten von Hardware-Interrupts bearbeiten. Zu- 
erst gibt es da die internen, vom Mikroprozessor 
ausgelösten Interrupts (Tabelle 1). Zum zweiten 
existiert der nicht maskierbare Interrupt 
(Interrupt 2 oder NMI), der vom NMI-Signal er- 
zeugt wird. Dieser Interrupt wird erzeugt, wenn 
beim 8088 und 8086 am Pin 17, beim 80286 am 
Pin 59 und beim 80386 am Pin 88 der Pegel auf 
high übergeht. Bei der IBM-PC-Familie 
(ausgenommen PCjr und Convertible) wird der 
NMI für Speicher-Paritätsfehler benötigt. Zum 
dritten gibt es die maskierbaren Interrupts, die 
normalerweise von Peripheriegeräten erzeugt 
werden. 

Die maskierbaren Interrupts werden über 
einen programmierbaren Interruptcontroller 
(PIC) 8259A an den Prozessor geleitet. Wenn der 


PIC eine Interruptanforderung erhält, signalisiert 
er durch das Aktivieren der Interrupt-Request- 
Leitung (INTR) dem Mikroprozessor, daß ein 
Interrupt bedient werden muß. Dieser Artikel be- 
schränkt sich auf die maskierbaren Interrupts 
und den 8259A, da Peripheriegeräte (Festplat- 
ten, serielle Schnittstellen und so weiter) so Zu- 
griff auf das Interrupt-System erlangen. 


Interrupt-Prioritäten 


Die Intel-Mikroprozessoren haben ein eingebau- 
tes Prioritätssystem für die Behandlung gleichzei- 
tig auftretender Interrupts. Höchste Priorität be- 
sitzen die internen Befehlsausführungs-Inter- 
rupts, wie Division durch O0 oder ungültiger Be- 
fehl, da die Priorität von der Interruptnummer 
bestimmt wird. Der Interrupt 0 hat die höchste 
Priorität, wogegen der Interrupt FFh nie bearbei- 
tet wird, solange ein anderer Interrupt aktiv ist. 
Wenn jedoch die Interrupt-Bearbeitung aktiv ist 
(das Interrupt-Flag im Mikroprozessor gesetzt 
ist), besitzten alle Hardwareinterrupts höhere 
Priorität als die Softwareinterrupts (INT-Be- 
fehle). Die Prioritäts-Reihenfolge nach Interrupt- 
Nummern darf nicht mit der Priorität der exter- 
nen Hardware-Interrupts verwechselt werden. 
Die hier besprochene zahlenmäßige Priorität gilt 
nur für die von der 8086-Mikroprozessor-Familie 
ausgelösten Interrupts und ist vollkommen unab- 
hängig von den System-Interruptprioritäten der 
externen Komponenten. 


Die Interrupt-Serviceroutinen 


In der Regel brauchen Programmierer keine 
hardwareabhängigen Routinen schreiben, die die 
Hardware-Interrupts bedienen. Die Routinen des 
IBM-PC-BIOS zusammen mit denjenigen von MS- 
DOS genügen in der Regel. In einigen Fällen bie- 
ten jedoch MS-DOS und das BIOS nicht genü- 
gend Unterstützung für einen hohen Programm- 
durchsatz. Hierzu zählt vor allem die Kommuni- 
kationssoftware. Die Programmierer benötigen 
dann direkten Zugriff auf den 8259A und den 
universellen asynchronen Receiver und Transmit- 
ter (UART). 

Es gibt zwei große Unterschiede zwischen den 
maskierbaren Interrupts und allen anderen 
Systemereignissen. Die maskierbaren Interrupts 
sind nicht vorhersagbar, und sie sind vergäng- 
lich. Normalerweise wird ein Hardware-Interrupt 
erzeugt, wenn ein Peripheriegerät das gesamte 
System benötigt. Falls das System nicht schnell 
genug antwortet, sind die Daten unwiederbring- 
bar verloren. 

Alle Dinge sind aber relativ, und dies gilt be- 
sonders für die Geschwindigkeit, mit der Inter- 
rupts bedient werden müssen. Nehmen wir zum 
Beispiel an, daß zwei Interrupts gleichzeitig auf- 
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» Bild 1: 
Generelle Interrupt- 
ausführung 
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treten. Einer stammt von einer seriellen Schnitt- 
stelle, die Daten mit 300 Baud empfängt, der an- 
dere ist von einer seriellen Schnittstelle, die 
Daten mit 9600 Baud empfängt. Die Daten vom 
ersten Kanal ändern sich 30 Millisekunden nicht. 
Die Daten des zweiten Kanals müssen aber inner- 
halb einer Millisekunde bearbeitet werden, um 
einen Datenverlust zu vermeiden. 


Flags pushen 


——— 


66 
Interrupts verhindern 


— 


+ 


£S:1P pushen 


— 


+ 


Adresse von ISR aus Tabelle 


und nach (S:IP bringen 


+ 


a 


Prozeß-Interrupt 


cS1P wiederherstellen, Flags 


Unvorhersagbarkeit 


Da die maskierbaren Interrupts als Folge eines 
externen Ereignisses wie dem Empfang eines 
Bytes über eine Kommunikationsschnittstelle auf- 
treten, kann der Zeitpunkt nicht vorhergesagt 
werden. Sogar der Timer-Interrupt, der fest 18,2 
mal je Sekunde auftritt, kann von einem Pro- 
gramm, das gerade läuft, nicht vorhergesagt 
werden. 

Wegen dieser Gegebenheiten muß das System, 
falls es Interrupts zuläßt, für deren Behandlung 
ausgelegt sein. Daher müssen die Interrupts, falls 
sie nicht bedient werden können, gesperrt wer- 
den. Die 8086-Mikroprozessor-Familie bietet 
einen Befehl Set Interrupt Flag (STD), um Inter- 
rupts zuzulassen, und einen Befehl Clear Inter- 
rupt Flag (CLD), um die Interrupts zu sperren. 
Das Interrupt-Flag wird automatisch gelöscht, 
sobald ein Hardware-Interrupt bearbeitet wird. 
Der Interrupt-Handler sollte sobald wie möglich 
einen STI-Befehl enthalten, um höher priorisierte 
Interrupts zuzulassen. 


Datenverlust 


Wie wir schon gesehen haben, muß ein maskier- 
barer Interrupt sofort bedient werden, um einen 
Datenverlust zu vermeiden. Sofort ist aber relativ 


zu der Datentransferrate des Peripheriegerätes. 
Die Regel ist, daß die gerade anfallende Daten- 
menge bearbeitet werden muß (zumindest in 
einem Puffer gespeichert) bevor die nächsten 
Daten ankommen. Ausgenommen Festplatten, 
die immer sofortige Bearbeitung verlangen, sind 
Interrupts von Einheiten, die Daten empfangen 
kritischer, als Interrupts von Einheiten, die Daten 
senden. 

Die Probleme des Datenverlusts bei Hardware- 
Interrupts werden durch die Einführung von 
Prioritäten für die Interrupts, die außerhalb des 
Mikroprozessors ausgelöst werden, vermieden. 
Geräten mit einer niedrigeren Datentransferrate 
wird eine niedrige Priorität zugewiesen. Die zeit- 
kritischen Einheiten erhalten die höchsten Priori- 
täten. 


Maskierbare Interrupts 


Der Mikroprozessor behandelt alle Interrupts 
(maskierbare, nicht maskierbare und Software) 
indem er die Flags auf dem Stack ablegt, das 
Interrupt-Flag löscht und die Inhalte der Register 
CS und IP auf dem Stack ablegt. 

Der Mikroprozessor holt sich dann die Inter- 
rupt-Nummer vom Datenbus, multipliziert sie 
mit 4 (die Größe eines Vektors in Bytes), und 
verwendet das Ergebnis als Offset in der Inter- 
rupt-Vektor-Tabelle, die sich in dem untersten 
(Segment 0000), 1 Kbyte großen Speicherbereich 
befindet. Die 4-Byte-Adresse an dieser Stelle wird 
dann als neuer Wert in die Register CS und IP 
geladen (Bild 1). 

Externen Geräten werden feste Interrupt-Lei- 
tungen (IRQ's) zugeteilt, die mit dem 8259A ver- 
bunden sind. Dies wird weiter unten noch erläu- 
tert. Benötigt ein Gerät eine Bearbeitung, so sen- 
det es über die IRQ-Leitung ein Signal an den 
PIC. Der PIC, der wie ein Erfüllungsgehilfe für 
das Gerät arbeitet, funktioniert wie in Bild 2 ge- 
zeigt. Er bewertet die Serviceanfrage, und falls 
sie richtig ist, aktiviert er die INTR-Leitung des 
Prozessors. Der Mikroprozessor prüft dann, ob 
Interrupts zulässig sind, ob also das Interrupt- 
Flag gesetzt ist. Ist dies der Fall, werden die Flags 
auf dem Stack abgelegt, das Interrupt-Flag ge- 
löscht, und die Inhalte der Register CS und IP auf 
dem Stack abgelegt. 

Der Mikroprozessor beantwortet die Interrupt- 
Anforderung durch das Aktivieren der Interrupt- 
Acknowledge-Leitung (INTA). Der 8259A gibt 
dann die Interrupt-Nummer auf dem Datenbus 
aus. Der Mikroprozessor holt sich die Interrupt- 
Nummer vom Datenbus und bedient den Inter- 
rupt. Vor dem Ausführen des IRET-Befehls muß 
die Interrupt-Serviceroutine dem 8259A eine 
»End of Interrupt«-(EOI)-Mitteilung senden. Dies 
wird durch Ausgeben des Wertes 20h an die 
Adresse 20h erledigt (die Übereinstimmung der 
Nummern ist rein zufällig). 


ıng 
Signalanfrage Sind 
1RQs 
aktiv? * 
| Ja 


Nein 
INTR high? 
ri 3a K a 
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| Nein 


Wurde INTs Nein 
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Int Ja 
bedient? 
Nein | Ja 
INTR 
Signalanfrage Flags pushen 
INTs sperren 
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INT 


ausmaskiert? 


— INT erkennen 
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— 


INT-Kummer auf 
Datenbus geben 
Daten- 


bus 
INT-Nummer holen 


D 


CS: 1P neu berechnen 


Der 8259A (Bild 2) besitzt viele interne Be- 
standteile, von denen einige durch die Software 
beeinflußbar sind. Nur die Einstellungen der 
IBM-PC-Familie werden hier behandelt. 

Drei Register beeinflussen das Bearbeiten der 
maskierbaren Interrupts: das Interrupt Request 
Register (IRR), das In Service Register (ISR) und 
das Interrupt Mask Register (IMR). 

Das IRR-Register wird benötigt, um festzu- 
stellen, für welches Gerät gerade eine Interrupt- 
anforderung vorliegt. Aktiviert ein peripheres 
Gerät seine IRQ-Leitung, um dem 8259A mitzu- 
teilen, daß es Bedienung benötigt, so wird im 
IRR ein Bit gesetzt, das der Interrupt-Ebene des 
Geräts entspricht. 

Das ISR gibt die Interrupt-Ebene an, die ge- 
rade bedient wird. Das ISR-Bit wird gesetzt, 
wenn die CPU (durch INTA) den Interrupt zu- 
läßt, und sich die Interrupt-Nummer auf dem 
Datenbus befindet. Das ISR-Bit bleibt bis zu der 
EOI-Sequenz gesetzt. 

Das IMR-Register kann beschrieben und gele- 
sen werden (an Adresse 21H). Hier können ein- 
zelne Interrupts gesperrt werden. Ist ein Bit in 
diesem Register gesetzt, ist die zugehörige IRQ- 
Leitung maskiert und wird nicht bedient, bis das 
Bit wieder gelöscht wird. So kann ein Interrupt 
gesperrt, die anderen aber weiterhin bearbeitet 
werden. 


DATENBUS = 


5 KONTROLLBUS - 


Der vierte große Block im Bild 3, bezeichnet 
als Priority Solver, ist ein komplexes Gebilde, 
welches das Herz des 8259A darstellt. Diese 
Komponente verknüpft die Inhalte der IMR, ISR 
und IRR, um zu entscheiden, falls eine Interrupt- 
anforderung vorliegt, ob diese bearbeitet werden 
soll, und dann die INTR-Leitung zum Prozessor 
aktiviert. Der Priority Solver kann sehr vielfältig 
programmiert werden. Hier wird aber nur der in 
den IBM PCs und in Kompatiblen verwendete 
Modus beschrieben. 


Die IRQ-Ebenen 


Stehen zwei oder mehrere unbediente Hardware- 
Interrupt-Anforderungen an, so entscheidet der 
8259A, welche zuerst bedient wird. Der Stan- 
dardmodus des PIC ist der vollständig geschach- 
telte Modus, bei dem die IRQ-Leitungen in einer 
festen Reihenfolge priorisiert sind. Nur IRQ-Lei- 
tungen mit einer höheren Priorität, als die gerade 
bearbeitete, dürfen Interrupts auslösen. 

Die höchste Priorität besitzt die Leitung IRQO, 
die niedrigste IRQ7. Wenn also gerade ein Inter- 
rupt 09h (ausgelöst durch IRQ1) bearbeitet wird, 
kann nur ein Interrupt 08h (ausgelöst durch 
IRQO) ihn unterbrechen. Alle anderen Interrupts 
werden verzögert, bis die Serviceroutine des 
Interrupts 09h beendet ist und EOI ausgegeben 
hat. 


Design mit 8 Ebenen 


Die IBM PC und PC/XT (und kompatiblen) Com- 
puter haben acht IRQ-Leitungen zum PIC - IRQO 
bis IRQ7. Diese Interrupt-Leitungen lösen die 
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> Tabelle 3: 
Interrupt-Zuordnung 
bei 8 Ebenen 


>> Bild 4: 

Eine grafische Dar- 
stellung der IRQ 
Prioritäten durch die 
Kaskadierung 


> Tabelle 4: 
Interrupt Zuordnung 
bei 16 Ebenen 
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Interrupts 08h bis OFh aus (also 8 + der IRQ- 
Ebene). Die 8 IRQ-Leitungen und die zugehöri- 
gen Interrupts sehen Sie in Tabelle 3. 


IRQ Interrupt Beschreibung 

Leitung 

IRQO 08H Timertick, 18,2 mal je 
Sekunde 

IRQ1 09H Tastatur benötigt Bedienung 

IRQ2 OAH Ein-/Ausgabe-Kanal (beim 
IBM PC/XT unbenutzt) 

IRQ3 OBH COM1 benötigt Bedienung 

IRQ4 OCH COM2 benötigt Bedienung 

IRQ5 ODH Festplatte benötigt Bedie- 
nung 

IRQ6 OEH Diskette benötigt Bedienung 

IRQ7 OFH Datenanforderung vom Pa- 


ralleldrucker I 


1 Diese Anforderung kann von den älteren IBM 
Monochrom-/Drucker-Adaptern nicht erzeugt 
werden. Druckertreiber, die auf diesem Signal 
basieren, arbeiten mit diesen Karten nicht. 


Design mit 16 Ebenen 


Im IBM PC/AT gibt es weitere acht IRQ-Ebenen. 
Dies wurde durch einen zweiten PIC, der kaska- 
diert ist, erreicht. So sind hier 16 Prioritäts- 
ebenen vorhanden. 


IRQ Interrupt Beschreibung 

Leitung 

IRQO 08H Timertick, 18,2 mal je Se- 
kunde 

IRQ1 09H Tastatur benötigt Bedienung 

IRQ2 OAH INT vom zweiten 8259A 

IRQ8 70H Echtzeituhr 

IRQ9 71H Software-Umleitung auf 
IRQ2 

IRQ10 72H Reserviert 

IRQO11 73H Reserviert 

IRQ12 74H Reserviert 

IRQ13 75H Numerischer Coprozessor 

IRQ14 76H Festplattenkontroller 

IRQ15 77H Reserviert 

IRQ3 OBH COM2 benötigt Bedienung 

IRQ4 OCH COM1 benötigt Bedienung 

IROQ5S ODH Datenanforderung von LPT2 

IRQ6 OEH Diskette benötigt Bedienung 

IRO7 OFH Datenanforderung von LPT1 


Die Kaskadierung besteht darin, daß die INT- 
Leitung des Slave 8259A mit der IRQ2-Leitung 
des Master 8259A verbunden ist, anstatt mit dem 
Mikroprozessor. Löst ein Gerät, das mit einer 
IRQ-Leitung des Slave 8259A verbunden ist, 
einen Interrupt aus, so wird die INT-Leitung des 


Slave aktiviert, was wiederum eine Interrupt-An- 
forderung an der IRQ2-Leitung des Masters aus- 
löst. Dies veranlaßt den Master, die INT-Leitung 
zu aktivieren, und die Anforderung dem Mikro- 
prozessor mitzuteilen. 

Der Mikroprozessor, der den Slave nicht 
kennt, erzeugt nur eine Interrupt-Bestätigung für 
die Anforderung des Masters. Dieses Signal er- 
halten beide 8259As, und der Master übergibt 
die Kontrolle dem Slave. Der Slave führt dann 
die Interrupt-Behandlung weiter durch. 

Beim IBM PC/AT erzeugen die zusätzlichen 
Interrupt-Leitungen die Interrupts 70h bis 77h 
(Tabelle 4). Da die acht zusätzlichen Leitungen 
an die Leitung IRQ2 des Masters führen, ist ihre 
Priorität höher als diejenige von IRQ3 bis IRQ7. 
Dieser Effekt ist grafisch in Bild 4 dargestellt. 
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Anmerkung: Während der INTA-Sequenz wird 
das entsprechende ISR-Bit in beiden 8259As ge- 
setzt. Deshalb müssen zwei EOI gesendet wer- 
den, um den Interrupt zu beenden. Eines an den 
Master, und eines an den Slave. 


Programmierung der 
Hardware-Interrupts 


Jedes Programm, das einen Interrupt-Vektor 
ändert, muß diesen vor der Rückkehr zu DOS 
oder seinem aufrufenden Prozeß zurücksetzen. 
Jedes Programm, das einen Hardware-Interrupt- 
handler ersetzt, muß alle Aufgaben des origina- 
len Interrupthandlers erledigen. Es muß die 
Interrupts wieder freigeben, dem Interruptcon- 
troller EOI senden und so weiter. Nichtbeachtung 
dieser Regeln führte bei vielen Programmierern 
schon zu mehrstündigen Fehlersuchen. 

Wird ein Interrupthandler vollständig durch 
einen eigenen ersetzt, so muß der originale Inter- 
rupt-Vektor gespeichert werden, so daß er am 
Programmende wieder zurückgesetzt werden 
kann. Obwohl es möglich ist, den 4 Byte großen 
Vektor im RAM direkt umzusetzen (und viele 
Programme tun dies auch), sollte man dies in 
Anbetracht auf Multitasking-Erweiterungen, oder 
spätere Versionen von DOS nicht tun. Die einzige 
empfehlenswerte Technik für das Lesen und Set- 


zen von Interrupt-Vektoren ist der Aufruf der 
entsprechenden MS-DOS-Funktionen. Die Funk- 
tionen 25h (Setzen des Interrupt-Vektors) und 
35h (Lesen des Interrupt-Vektors) des Interrupts 
21h erledigen dies. 

Nachdem der originale Vektor gespeichert 
wurde, kann er durch einen Far-Zeiger, der auf 
die Ersatzroutine zeigt, ersetzt werden. Die neue 
Routine muß mit einem IRET-Befehl enden. Sie 
sollte auch alle Prozessorregister und Zustände 
am Beginn retten und vor dem Ende wiederher- 
stellen. 


Ersatz-Interrupthandler 


Denken Sie an ein Programm, das viele mathe- 
matische Berechnungen mit zufälligen Werten 
durchführt. Um einen abnormalen Abbruch 
durch den MS-DOS-Interrupt OOh-Handler zu 
vermeiden, wenn ein DIV- oder IDIV-Befehl mit 
dem Divisor 0 bearbeitet wird, kann der Pro- 
grammierer die Interrupt-Routine 00h (Division 
durch 0) durch eine Routine ersetzen, die den 
Anwender informiert, was geschehen ist, und 
dann die Bearbeitung ohne Abbruch fortsetzt. 
Das COM-Programm DIVZERO.ASM (Listing 1) 
erledigt dies. 


Unterstützende 
Interrupthandler 


In vielen Fällen unterstützt ein Interrupthandler 
einen existierenden, anstatt ihn zu ersetzen. Die 
zusätzliche Routine kann die Daten bearbeiten, 
bevor sie sie an die eigentliche Interrupt-Routine 
weitergibt. Sie kann aber auch die Bearbeitung 
nach dem Aufruf der originalen Interrupt-Rou- 
tine erledigen. Diese Fälle verlangen ein unter- 
schiedliches Kodieren der Handler. 

Soll die zusätzliche Routine vor dem origina- 
len Handler ausgeführt werden, so ruft die zu- 
sätzliche Routine den Original-Handler am Ende 
auf. Dieser Aufruf kann indirekt über den am An- 
fang gespeicherten Original-Interrupt-Vektor er- 
folgen. Ein zusätzlicher Interrupt-Handler, der 
zum Beispiel beim Auftreten eines Interrupts 08h 
einen internen Zähler erhöht, kann wie in Listing 
2 aussehen. 

Der zusätzliche Handler muß alle Register und 
Maschinenzustände belassen, außer diejenigen, 
die er gezielt ändern will. Hier ist dies der Wert 
von myflag (und das Flag-Register, das aber 
durch den Interrupt-Vorgang gerettet wird). Die 
Register und die Maschinenzustände müssen vor 
dem Aufruf des Original-Handlers wieder herge- 
stellt werden. 

Die Sache ist etwas komplizierter, wenn die 
zusätzliche Interrupt-Routine nach der originalen 
Interrupt-Routine in Aktion treten soll, und be- 
sonders, wenn die zusätzliche Routine nicht wie- 


dereintrittsfest ist. In diesem Fall muß der zu- 
sätzliche Handler geschachtelte Interrupts ver- 
hindern. So darf der zusätzliche Handler nicht 
durch einen Interrupt unterbrochen werden, 
selbst wenn der Original-Handler vorher ein EOI 
ausgegeben hat. Statt der vorhergehenden Inter- 
rupt-Routine 08h kann der Programmierer das 
Programmstück in Listing 3 verwenden, um 
myflag als Semaphore zu benutzen und mit der 
Funktion XCHG zu testen. 

Beachten Sie, daß solch ein Interrupt-Handler 
den Original-Interrupt-Aufruf simulieren muß, 
indem er zuerst die Flags auf dem Stack ablegt 
(PUSHF) und dann einen Far-CALL ausführt. Die 
auf dem Stack abgelegten Flags werden durch 
den IRET-Befehl der Original-Handler-Routine 
wieder geladen. Nach der Rückkehr vom Origi- 
nal-Handler kann die zusätzliche Routine den 
Maschinenzustand retten und seine eigene Bear- 
beitung durchführen. Das Ausführen des IRET- 
Befehls führt dann zum unterbrochenen Pro- 
gramm zurück. 

Die Flags in der zusätzlichen Routine brauchen 
nicht gerettet zu werden, da sie automatisch vom 
IRET-Befehl mit dem Originalwert geladen wer- 
den. Wegen dieser Art der Interrupt-Behandlung 
sollte die Interrupt-Routine nicht von Informa- 
tionen der Flags abhängen, und sie kann ebenso 
keine Informationen ins Flag-Register zurücklie- 
fern. Beachten Sie auch, daß der Original-Hand- 
ler (der durch den indirekten CALL aufgerufen 
wird) den Interrupt abgeschlossen hat, da er das 
EOI an den 8259A gesendet hat. Deshalb ist der 
Zustand der Maschine nicht derselbe wie im 
ersten Beispiel. 

Beim Zurückspeichern des geretteten Inter- 
rupt-Vektors braucht das Programm nur den 
neuen Vektor (in der Vektortabelle) durch die 
gespeicherte Kopie zu ersetzen. Ist die Ersatz- 
Interruptroutine Teil einer Applikation, so muß 
der Original-Interrupt-Vektor bei jeder Möglich- 
keit des Programmendes (Control-C, Control- 
Break und kritischer Programmabbruch im Feh- 
lerfalle) zurückgespeichert werden. Unterbleibt 
dies, so ist der Systemabsturz gewiß. Obwohl 
dies nicht sofort der Fall sein muß, trifft das doch 
ein, sobald ein anderes Programm den Speicher- 
bereich des Interrupt-Handler-Codes belegt. 


Zusammenfassung 


Handler-Routinen für Hardware-Interrupts, ob- 
wohl sie kein Bestandteil von DOS sind, werden 
doch von vielen MS-DOS-Applikationen verwen- 
det. Routinen dieses Typs spielen in der Funktio- 
nalität des IBM Personalcomputers eine große 
Rolle und können den Durchsatz eines Pro- 
gramms, wenn sie gut programmiert sind, erheb- 
lich verbessern. Unter gewissen Gegebenheiten 
gibt es keine andere praktikable Methode. 
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Listing 1: 

Der Ersatz-Interrupt- 
Handler für die Divi- 
sion durch 0 
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name 
title 


divzero 
"DIVZERO — Interrupt OOH Handler' 


; 

;DIVZERO.ASM: Demonstration Interrupt 00H Handler 

;This code is specific to 80286 and 80386 microprocessors. 
;To assemble, link, and convert to a COM file: 


» 
; MASM DIVZERO 
b LINK DIVZERO 
R EXE2BIN OIVZERO.EXE DIVZERO.COM 
; DEL DIVZERO.EXE 
; 
er equ Odh ; ASCII carriage return 
if equ Oah ; ASCII linefeed 
eos equ 4 So ‚ end of string marker 
_TEXT segment word public "CODE' 
assume cs: TEXT,ds:_TEXT,es:_TEXT,ss:_TEXT 
org 100h 
entry: jmp start ; skip over data area 
intmsg db 'Divide by Zero Occurredi',cr,If,eos 
divmsg db "Dividing ' ; message used by demo 
parl db *0000h' ; dividend goes here 
db byu 
par2 db '00h' ; divisor goes here 
db ' equals ' 
par3 db '00h' ; quotient here 
db 'remainder' 
par4 db '00h' ; and remainder here 
db er,if,eos 
oldintO dd ? ; save old IntOOH vector 
intflag db 0 ; nonzero if divide by 
; zero interrupt occurred 
oldip dw 0 ; save old IP value 


; 
;The routine 'int0' is the actual divide by zero interrupt handler. 
‚It gains control whenever a divide by zero or overflow occurs. Its 
‚action is to set a flag and then increment the instruction pointer 


‚saved on the stack so that the failing divide will not be reexecuted 


;after the IRET. 


; 
;In this particular case we can call MS-D0S to display a message during 


;interrupt hand 
‚intentionally. 


ing because the application triggers the interrupt 
Thus, it is known that MS-D0S or other interrupt 


‚handlers are not in control at the point of interrupt. 


int0: pop 


push 
push 


cs:oldip ;capture instruction pointer 


cs ; set DS = (S 
ds 


ah,09h ; print error message 
dx,offset _TEXT:intmsg 
21h 


oldip,2 ; bypass instruction causing 
; divide by zero error 

intflag,1 ; set divide by 0 flag 

es ‚ restore all registers 

ds 

si 

di 

dx 

cx 

bx 

ax 


cs:oldip ; restore instruction pointer 


; return from interrupt 


B 
;The code beginning at 'start' is the application program. It alters 


;the vector for 


Interrupt 00H to point to the new handler, carries 


‚out some divide operations (including one that will trigger an 


;interrupt) for 


demonstration purposes, restores the original 


‚contents of the Interrupt 00H vector, and then terminates. 


start: mov 
int 


ds 
mov 
int 


mov 
int 


ax,3500h ; get current contents 
21h ; ofInt 00H vector 


; save segment:offset 

; of previous Int 00H handler 
word ptr oldint0,bx 
word ptr oldintO+r2,es 


; install new handler ... 
dx,offset intO ; DS:DX = handler address 
ax,2500h ; call MS-005 to set 
21h ; Int 00H vector 


; now our handler is active, 
; carry out some test divides. 


ax,20h ; test divide 
bx,1 ; divide by 1 
divide 
ax,1234h ; test divide 
bx,5eh ; divide by 5EH 
divide 
ax,5678h ; test divide 
bx,7fh ; divide by 127 
divide 
ax,20h ; test divide 
bx,0 ; divide by 0 
divide ; (triggers interrupt) 
; demonstration complete, 
; restore old handler 
dx,oldintO ; DS:0X = handler address 
ax,2500h ; call MS-DOS to set 


21h ; Int 00H vector 


ax,4c00h ; final exit to MS-D0S 
21h ; with return code = 0 


;The routine 'divide' carries out a trial division, displaying the 
;arguments and the results. It is called with AX = dividend and 


;BL = divisor. 


; 
divide proc 


push 
push 


mov 
call 


mov 
mov 
call 


nodiv: mov 


divide endp 


wtoa proc 


push 
mov 
call 
add 
pop 
call 
ret 


wtoa endp 


near 


ax ; save arguments 
bx 


di,offset parl ; convert dividend to 
wtoa ; ASCII for display 


ax,bx ; convert divisor to 
di,offset par2 ; ASCII for display 
btoa 
bx ; restore arguments 
ax 
bi ; perform the division 
intflag,O ; divide by zero detected? 
nodiv ; yes, skip display 
ax ; no, convert quotient to 
di,offset par3 ; ASCII for display 
btoa 
ax ; convert remainder to 
ah,al ; ASCII for display 
di,offset par4 
btoa 
ah,09h ; show arguments, results 
dx,offset divmsg 
21h 
intflag,O ; clear divide by 0 flag 
; and return to caller 
near ; convert word to hex ASCII 
; call with AX = binary value 
3 DI = addr for string 
; returns AX, CX, DI destroyed 
ax ; save original value 
al,ah 


btoa ; convert upper byte 
di,2 ; Increment output address 


convert lower byte 
return to caller 


btoa proc 


btoa endp 


ascii proc 


ascii2 ret 
ascii endp 
_TEXT ends 


myflag dw 


oldint8 dd 


Sagen Sie 


near ; convert byte to hex ASCII 
call with AL = binary value 


; 
i DI = addr to store string 
; 


; returns AX, CX destroyed 


ah,al ; save lower nibble 
cx,4 ; shift right 4 positions 
al,c! ; to get upper nibble 
ascii ; convert 4 bits to ASCII 
[di],al ; store in output string 
al,ah ; get back Iower nibble myintß: 
al,ofh ; blank out upper one 
ascii ; convert 4 bits to ASCII 
[di+1],al ‚ store in output string 
; back to caller 
near ; convert AL bits 0-3 to 
; ASCII (0...9,A...F) 
al,'0' ; and return digit in AL myint: 
al,'g' 
ascii2 
al,'a'-'9'-1 ; "fudge factor" for A-F 
; return to caller 
entry 
? ; variable to be incremented 
; on each timer-tick interrupt 
? ; contains address of previous 
; timer-tick interrupt handler 
; get the previous contents 
; of the Interrupt 08H vector... 
ax,3508h ; AH = 35H (Get Interrupt Vector) 
21h ; AL = Interrupt number (08H) 
word ptr oldintd,bx ‚ save the address of the myint8x: 


word ptr oldint8+2,es 


Neue Tips 
und neue Tools 
für System-Entwickler. 


; previous Int 08H Handler 


Fingerspitzen- 
gefühl allein reicht 
heute nicht mehr 
aus, wenn man 
perfekte Qualität 
in der Program- 
mierung liefern 
will. 
PEM bietet Ihnen 
jetzt innovative, 
praxisnahe Tools 


an, deren sofortiger 


Nutzen begeistert. 


mov dx,seg myint8 ; put address of the new 
mov ds,dx ; interrupt handler into DS:DX 
mov dx,offset myint8 
mov ax,2508h 


int 21h ; AL = Interrupt number (08H) 
. 


; this is the new handler 
; for Interrupt 08H 


inc cs:myflag 
; timer-tick interrupt 


Jjmp dword ptr cs:[oldint8] ; then chain to the 
; previous interrupt handler 


; this is the new handler 
; for Interrupt 08H 


mov ax,l ; test and set interrupt- 

xchg cs:myflag,ax ; handling-in-progress 
; semaphore 

push ax ; save the semaphore 

pushf ; simulate interrupt, 


; allowing the previous 

call dword ptrces:oldint& ; händler for the 
; Interrupt 08H 
; vector to run 


; get the semaphore back 
or ax,ax ; is our interrupt handler 
; already running? 
inz myintßx ; yes, skip this one 


ai ; now perform our interrupt 
; processing here... 


mov es:myflag,O ; clear the interrupt- 
; handling-in-progress 
flag 


iret ; return from interrupt 


Gratis-Info für Sie 
DI Magic£V. Die perfekte Lösung 
Übrigens: MagicCV gibt es 
DI HeapReport. Sorgt für den 
HeapReport ist für MS 
Prototyping für ©. Auto 
Keine lästige manuelle Di 
MSDOS und SCO-Xenix. 
Ankreuzen genügt - schi 
Informationen. Coupon aussc! " 
- Absender nicht vergessen — 


PE 


MagicCV. Reg. Trademark Nu-Mega Techn, CodeView, 


MS-Windows. Reg. Trademark Microsoft 


; and call MS-D0S to set vector 
; AH = 25H (Set Interrupt; Vector) 


; increment variable on each 


«4 Listing 1: 
Ende 


«Listing 3: 
Ersatz-Interrupt- 
Handler mit 
Semaphoren 


44 Listing 2: 
Beispiel für einen zu- 
sätzlichen Interrupt- 
Handler 
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Siemens HighScan 800 im Kurztest: 


Ein Scanner 
für alle 
Zwecke 


Ein für viele Entwickler leidiges 
Thema sind die Dokumentationen 
zu den fertiggestellten Produkten. 
Vielfach ist nicht nur das »Wie« 
eine Frage - ein Entwickler kennt 
sein Programm ja in- und auswen- 
dig, wozu also diese detaillierten 
Beschreibungen -, sondern auch 
das »Womit«. Eine Antwort darauf 
wird in diesem Heft im Artikel 
über Word 5 gegeben. Eine sinn- 
volle Ergänzung dazu stellt ein 
Scanner dar, mit dem bereits ange- 
fertigte Zeichnungen oder auch 
maschinengeschriebene Texte (das 
soll's noch geben) in den Computer 
gelangen. 


ie Scannerfamilie von Siemens besteht aus 

den Modellen HighScan 400, 600 und 800, 
mit eben diesen Auflösungen, gemessen in dpi 
(dots per inch). Ihre hohe Auflösung — vor allem 
der Modelle 600 und 800 - bringt sowohl bei 
graphischen Anwendungen als auch bei der 
Schrifterkennung Vorteile. 


HighScan 


Mit der Auflösung des HighScan 800, den wir 
ausprobieren konnten, will Siemens in bisher 
nicht erreichte Regionen vorstoßen. Doch das sei 
gleich an dieser Stelle gesagt: Wenn Sie diese 
Auflösung nutzen wollen, sollte Ihre Festplatte 
nicht nur eine Kapazität von mindestens 100 
Mbyte haben, sie sollte auch noch größtenteils 
frei sein. Bei einer Schwarz/Weiß-Darstellung 
der größtmöglichen Fläche werden insgesamt 
65.280.000 Punkte erfaßt, das sind rund 8 
Mbyte. Wird gleiches in den möglichen 64 
Graustufen erfaßt, erhöht sich der Speicher- 
bedarf auf 48 Mbyte — wohlgemerkt, für ein 
(allerdings sehr großes) Bild. 

Ein weiterer Einsatzschwerpunkt der hoch- 
auflösenden HighScan-Modelle ist die optische 
Zeichenerkennung (OCR). So lassen sich schon 
mit einer physikalischen Auflösung von 400 dpi 
etwa auch Petitschriften im 6-Punkt-Bereich ver- 
arbeiten, z.B. bei der lernfähigen OCR-Software 
Optopus. Auch bei einer vortrainierten OCR- 
Software, wie z.B. Recognita, zeigt sich, wie sehr 
es beim Einlesen durch den Scanner auf eine 
möglichst hohe Auflösung ankommt. Auf dieses 
Produkt, das uns in einer Demo-Version vorlag, 
werden wir später noch eingehen. 


Die nüchterne Hardware 


Der Scanner präsentiert sich in einem nüchter- 
nen, kantigen, grauen, aber funktionellen Ge- 
häuse. Die Vorlagen werden unter den nach oben 
schwenkbaren Deckel auf eine Glasplatte gelegt. 
Die Verbindung mit dem Rechner stellen eine 
mitgelieferte SCSI-Schnittstelle auf einer kurzen 


Bild 1: 

Aus der mit Prescan 
als reines 
Schwarz/Weiß-Bild 
erfaßten Vorlage 
wird ein Ausschnitt 
gewählt. 
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Karte sowie ein dickes Kabel her. Also, hier muß 
ein wenig geschraubt und gesteckt werden, was 
aber auch für einen Hardware-Laien kein Pro- 
blem sein dürfte. 


Vertikal: 


549 


Pels 


Pels ol } 
2976 |Pels 


Länge Stufen 
Pels | 


64 


Auflösung in dots 
800 


niedriger |+ 


per inch (dpi) 


Per 


24 heller dunkler 


— 


Platzbedarf: 


6594 KB 


[ Apprecnen ) 


Bild 2: 

Hier stellen Sie die 
Parameter ein, mit 
denen die Vorlage 
gescannt werden soll. 
Dabei wird der 
Platzbedarf auf der 
Festplatte gleich mit 
angezeigt. 


Der Scanner kann Vorlagen bis zu einer Größe 
von 8,5 x 12 Zoll erfassen. Bei der Abtastung 
wird die Vorlage mit LEDs beleuchtet und die re- 
flektierte Helligkeit von einem CCD-Sensor 
(Charge Coupled Device) »gemessen« und in 
elektrische Signale umgesetzt. Diese werden in 
Bits und Bytes umgewandelt und in dem 2 Mbyte 
großen Bildspeicher des Scanners zwischengela- 
gert, bevor sie über die SCSI-Schnittstelle in den 
Rechner geschaufelt werden. 


Lage 
Krümnung = 


FREE EEE >) 


Kontrast - 7% 
FE TEE TRRREERT +) 


Helligkeit = 5 
Ve ERBE — EIDERBISEN + 


Raster 


Bild 3: 

Mit dem Menü Bild- 
Einstellen können Sie 
verschiedene Effekte 
erreichen. 
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Die vielfältige Software 


Für die High-Scanner von Siemens werden eine 
ganze Reihe Softwareprodukten am Markt ange- 
boten. Außerdem können die abgetasteten und 
aufbereiteten Text-, Bild- und Grafikdaten in 
vielen Standardprogrammen, wie z.B. Word oder 
PageMaker, weiterverarbeitet werden. 


Pünktchen für Pünktchen 

Der eigentliche Vorgang des Scannens ist denk- 
bar einfach, nicht zuletzt aufgrund der unter 
Windows laufenden HighScan-Software. 

Um den Bildausschnitt zu bestimmen — meist 
braucht man nur einen Teil der Vorlage — wird 
erst einmal vorgescannt. Jetzt kann man den 
Bildausschnitt vergrößern, stufenweise bis zu 
Faktor 16 (Bild 1). 

Nun kann man sich entscheiden, ob man eine 
Strichzeichnung in zwei Stufen oder ein Foto in 
64 Stufen (Halbton), wie in Bild 2 dargestellt, 
scannen will. Die Auflösung kann in Stufen von 1 
dpi von 50 bis 800 dpi eingestellte werden. Die 
Zeichnung vom Space Shuttle haben wir natür- 
lich nur in zwei Stufen in den Auflösungen 200, 
400, 600 und 800 dpi abgetastet, wobei die Datei 
mit der letzteren Auflösung einen Umfang von 
knapp 180 Kbyte hat. 

Die damit erzielten Ergebnisse sind in Bild 4 
bis 6 bis 600 dpi dargestellt. Wir haben darauf 
verzichtet, auch noch die höchste Auflösung zu 
zeigen, da der Laserbelichter sonst unnötig lange 
wegen dieses einen Bilds beschäftigt gewesen 
wäre. Ohnehin mußte der Druckertreiber von 
Word umgeschrieben werden, da er die Auflö- 
sung auf 300 dpi begrenzt. 

Eingescannte Halbtonvorlagen können Sie in 
einer »elektronischen Dunkelkammer« nachbear- 
beiten (Bild 3). Hier läßt sich die Bildqualität mit 
den verschiedensten Mitteln wie Krümmung, 
Kontrast, und Helligkeit beeinflussen. 

Die so bearbeiteten Bilder bzw. Ausschnitte 
(bis zu 99 sind möglich) können Sie in verschie- 
denen gängigen Formaten abspeichern: TIFF 
(Word, Pagemaker), IMG (Ventura Publisher), 
PCX (Paintbrush), MSP (Windows Paint). Beim 
Abspeichern im TIFF-Format fiel auf, daß die 
High-Scan-Software die Datenkompression noch 
nicht unterstützt und auch die Bildgröße nicht 
mit festhält. 


Ich erkenne Ihren Charakter 

Die optische Zeichenerkennenung (OCR, optical 
character recognition) — ein Einsatzbereich, der 
von etwa 30% der Scannerbesitzer genutzt wird 
— haben wir mit dem ungarischen windows- 
ähnlichen Programm Recognita (Preis etwa DM 
3000,-) mit ausprobiert. 


Schlußbemerkung 


Der High-Scan 800 (Preis ca. DM 14.000) war 
leicht zu bedienen und lieferte gute Ergebnisse 
sowohl bei der Bildverarbeitung als auch bei der 
Zeichenerkennung. Bei der Anschaffung eines 
solchen Geräts sollten Sie jedoch bedenken, ob 
Sie die hohe Auflösung nutzen können, oder 
vielleicht mit einem Modell 600 oder 400 aus- 
kommen. 

Hartmut Niemeier 


Bild 4: i 
Greifen Sie für uns a 


zur Feder! 


Bild 5: 
Gescannt mit 
400 dpi. 


Wir suchen schreibfreudige Bild 6: 


Experten Dr 


Wenn Sie Ihr Wissen 
über Programmierung oder über 
Standard-Anwendungen 
nicht für sich behalten und 
daraus Kapital schlagen wollen, 
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Vorschau 


Im Heft 6/89 (November/Dezember) werden Sie 
unter anderem folgende Artikel finden: 


MS 0S/2 

DDE unter dem Presentation Manager 
Entwicklung eines Multithread-Programms 
Bildschirmansteuerung unter MS 0S/2 

Aufbau und Einsatz von Dynamic Link Libraries 
OS/2-Systemaufrufe von Basic aus verwenden 


C 

SAA-Serie, Teil 6 (Dialogboxen) 

Erweiterte Techniken für Strukturen und Unions 
inC 

C-Kurs für Umsteiger, Teil 2 


Windows 
Erweiterung der Windows-Dialogboxen mit 
neuen Steuerungsklassen 


MS-DOS 

Speicherbeschränkungen umgehen mit einem 
Overlay-Manager 

Die EXEC-Funktion von MS-DOS 


Darüber hinaus werden wir über einige interes- 
sante neue Produkte von Microsoft berichten. 
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Liebe Softwareknacker. 
Es ist völlig zwecklos, dem neuen 
Hardlock E-Y-E schöne Augen zu machen. 
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Softwareschutz braucht einen seriösen Partner. 
Wer beim Schutz seiner Software kein Auge 

mehr zudrücken möchte, landet irgendwann bei 
FAST Electronic. Seit 1985 haben wir über 120.000 
Hardlock-Module produziert. Und verkauft. Denn 
Hardlock ist kein gewöhnlicher Kopierschutz. 
Hardlock ist Softwareschutz durch Hardware. 
Transparent. Anreihbar. Und durch die einzigartige 
Encryption-Technique nicht zu knacken. 


Hardlock E-Y-E - ein eigener Chip für den 
Softwareschutz. 

Der Vorsprung wird größer. Das neue 

Hardlock E-Y-E basiert auf einem Chip, den 
FAST Electronic eigens zum Schutz von Software 
entwickelt hat. Hardlock E-Y-E ist cryptoprogram- 
mierbar. Das heißt, es kann von Ihnen selbst 
programmiert werden - und von niemand ande- 
rem. So sind Sie flexibler beim Schutz von 
Programmoptionen. Im neuen Hardlock E-Y-E 
können optional bis zu 128 Byte Daten abgelegt 
werden. Und mit dem automatischen Einbindungs- 
programm HL-Crypt schützen Sie Ihre .COM- 
und .EXE-Files in Sekundenschnelle. Für die 


individuelle Einbindung erhalten Sie ohne Aufpreis 
Abfrageroutinen für alle gängigen Compiler. 


Testen Sie den neuen Chip. 

FAST Electronic hat eine halbe Million Deutsche 
Mark investiert, um Hardlock noch sicherer zu 
machen. Aber nicht teurer. Es lohnt sich, unsere 
Konditionen zu 
kennen. Und 
Leistung und 
Preis mit ande- 
ren Systemen zu 
vergleichen. Sie 
werden sehen: 
Gerade bei gro- 
Ben Stückzahlen 
können wir 
Ihnen konkur- 
renzlos günstige 
Angebote kalkulieren. Bestellen Sie ein Test-Modul 
des neuen Hardlock E-Y-E unverbindlich zur 
Ansicht. Jetzt. 


MFFA=T 


Fast Electronic GmbH 


Das neue Hardlock E-Y-E: 
Sicherheit in Silizium. 


FAST Electronic GmbH, Kaiser-Ludwig-Platz 5, 8000 München 2, Tel. (089) 532653, Fax (089) 53 34 01 


Einsteigen leichtgemacht! 
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Basic Bestell-Nr. 56552 
Künstliche Intelligenz 
Bestell-Nr. 56558 

MS-DOS 3.3 Bestell-Nr. 56559 
Unix Bestell-Nr. 56555 

dBase Ill Plus Bestell-Nr. 56549 
Turbo Pascal 4.0 

Bestell-Nr. 56550 


Lernen am PC: 

Interaktive Lernprogramme 
eignen sich hervorragend, für 
einen ersten Einstieg in neue 
Themenbereiche. Sie können 
sich als Anfänger Grundwis- 
sen zu bestimmten Program- 
men aneignen und so Verän- 
derungen in Schule und Beruf 
schnell gerecht werden 
Einsteigen leichtgemacht: 
Durch Simulation am PC erar- 
beiten Sie sich schrittweise 
die Grundfunktionen zu den 
verschiedenen Programmen. 
Jede Lernsoftware ist in ein- 
zelne Lektionen eingeteilt. 
Dadurch können Sie selbst 
bestimmen, welche Kapitel Sie 
bearbeiten möchten. In klei- 
nen Übungen am Ende eines 
jeden Kapitels können Sie das 
neu erworbene Wissen sofort 
umsetzen und vertiefen. Die 
Übungen dienen als Lernkon- 
trolle und können beliebig 
wiederholt werden. 


| mit 500 aktuellen Computerbüct 


PLZ 


LZIC 


Bitte ausschneiden und 
Buch- und Softwa 


| Bitte senden Sie mir Ihr Gesamtve 


C Bestell-Nr. 56551 

Word 4.0 Bestell-Nr. 56553 
Schach Bestell-Nr. 56554 

In Vorbereitung: 

PC-/MS-DOS 4.0 

Bestell-Nr. 56594 

Multiplan 3.0 Bestell-Nr. 56593 
Word 4.0, Teil 2 Bestell-Nr. 56592 
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Jede Lernsoftware: 


DM 9 


Fa 72,-1öS 790,-) 
erbindliche Preisempfehlung 

Übrigens gibt es alle Lernsoft- 
ware-Programme auf 54" und 
3Y»”-Disketten. Bitte fügen Sie 
für die 3%2"-Version bei Ihrer 
Bestellung am Ende der 
Bestell-Nummer ein »D« an 


Markt & Technik-Produkte 
erhalten Sie bei Ihrem 
Buchhändler, in Computer- 
Fachgeschäften oder in 
den Fachabteilungen der 
Warenhäuser. 


Markt&fechnik 


Zeitschriften - Büct 
Software Sn 


README.EXE und READ.ME: Diese Datei und ein 
Programm zur Anzeige derselben. 

\8259: Listings aus dem Artikel »Steuerung von Ein-/ 
Ausgabegeräten«, $.166 

\BASIC: Listings aus dem Artikel »Basic als professio- 
nelle Programmiersprache«, S.59 

\OOP: Listing aus dem Artikel »Das neue Quick- 
Pascal«, S.68 

\SAAS: Listings aus dem Artikel »Erstellung und ver- 
waltung von SAA-Dialogboxen«, S.116 

\VEC: Listings aus dem Artikel »Vektorfonts unter dem 
Presentation Manager«, S.6 

\VMM: Listings aus dem Artikel »Eine virtuelle Spei- 
a in C«, S.104 

\WINHELP! Listings aus dem Artikel »Hilfe-Verwal- 
tung für S.30 

(C) Cop ht 1989 Microsoft GmbH, Unterschleiß- 
heim. Alle‘ vorbehalten. 


Sollte sich diese Diskette als defekt erweisen, 
schicken Sie sie bitte an folgende Adresse: 


Microsoft System Journal 
Vertriebsservice 
Postfach 6740 

D-8700 Würzburg 1 


Die Diskette zum 
Microsoft System Journal 
Sept./Okt. 1989 


README.EXE 


L2.LST L3.LST 


WORDWRAP.BAS 


DLGAB.C DLEDEMO.C DLGEDIT.C DLG.H 
VECTFONT.C 


VFOa.C. 
vr1.c 


vroo.C 
VFOS.C 
YAO.E 


VFol.c 
vr06.C 


ein neues 


Sie erhalten dann umgehend 
Exemplar. 


Verzeichnisstruktur 
der Diskette 
MSJDSK35 


Jetzt zum Abo-Vorteilspreis bestellen! 


Vorsprung sichern - 
aus erster Hand 
informieren. 

MS Journal ..\etc 


im Jahresabonnement 
nur DM 36,- 
im 2-Jahresabonnement 


= eke 


L 


Jetzt zum Abo-Vorteilspreis bestellen! 


Insider-Informationen für Programmierer, 
Softwareentwickler, Systemdesigner und er- 
fahrene Anwender von Microsoft-Software. 


Microsoft System Journal 
im Jahresabonnement ( 6 Ausgaben) zu DM 115,- 
im 2-Jahresabonnement (12 Ausgaben) zu DM 210,- 


ee Listings auf Diskette zum Compilieren oder 
zur schnellen Übernahme in Programme. 
Lieferbar auf 5Y4”Disketten 360 KB für 


nel 
9° IBM PC und Kompatible 
Microsoft System Journal + Diskette 


im Jahresabonnement ( 6 Ausgaben) zu DM 230,- 
im 2-Jahresabonnement (12 Ausgaben) zu DM 420,- 


> Yi 


Treffsicher ! 


Ihre Anzeige 


im 


Microsoft 


SYSTEM JOURNAL 


Nutzen Sie die qualifizierte Zielgruppe für Ihre 
Produkt- und Stellenanzeigen. 


